병 렬 가상기 계 (PVM) 서 고함수 


국가과학원 콤퓨터 과학연구소 


주체 98(2009) 년 4 월 



병 렬 가상기 계 의 서 고함수들 


여기서는 모든 병렬가상기계함수들을 자모순서로 서술한다. 매 
함수들은 C 언어 와 포트란언어 에 대 하여 따로 따로 설 명한다. 또한 매 
함수들에 대 한 실 례프로그람들도 제 시하였 다. 

pvmfaddhostO pvm_addhosts() 

한개 이 상의 처 리 기 들을 가상기 계 에 첨 부한다. 

문법 

C： 

int info = pvm_addhosts( char **hosts，int nhost, 

int *infos ) 

포트란: 

call pvmfaddhost( host, info ) 

변수: 

hosts - 추가하여야 할 처리기들의 이름을 포함한 문자배렬에로의 
지적자 

nhost - 주가해 야 할 처 리 기 들의 개 수를 지 적 하는 옹근수 
infos - 이 함수가 돌려 주는 개 별 적 인 처 리 기 들의 상태 코드 

를 가지고있는 길이가 nhost 인 옹근수배 렬，오유가 생긴 
경 우에 는 령보다 작은 값이 들어있 다. 
host - 추가해 야 할 처 리기의 이름이 들어 있는 문자배 렬 
info - 이 함수가 되 돌리 는 상태코드， nhost 보다 작은 값은 
부분적 인 실패 를 나타내 며 1보다 작으면 모두 실패하였음을 
보여 준다. 

설명: 

pvm_addhosts 는 가상기 계 를 구성 하기 위 하여 현재 의 처 리 기 들의 
구성 에 hosts 로 지적한 처 리기들의 목록을 첨가한다. 

만일 pvm_addhosts 가 성공하면 info 는 nhost 와 같다. 

부분적 으로 실 패하는 경 우에 는 1 <= info < nhost 이 며 완전한 
실패이면 info < 1 이다. 어느 처리기에서 오유가 일어났는가는 배렬 




infos 를 검사하여 결정한다. 포트란함수 pvmfaddhost 는 한번 호출에서 
한개 의 처 리 기 만을 추가한다. 실 패 하면 병 렬 가상기 계 체 계 는 이 함수를 
다시 호출한다. 

리용자는 이 기 능을 리용하여 응용프로그람의 오유허 용능력 을 
개 선할수 있 다. 응용프로그람에 서 는 pvm _ mstat 와 pvm _ config 를 리용 
하여 처 리기들의 상태를 문의할수 있다. 

만일 처리기가 실패하면 그 처리기는 자동적으로 처리기구성에서 
지 워 진 다. pvm _ addhosts 지 령 으로 리 용자는 응용프로그람에 서 새 로운 
처리기를 추가할수 있다. 

이 것은 응용프로그람작성 자가 프로그람을 작성할 때 처 리 기의 실패 에 
대응하여 오유허용능력을 높일수 있도록 한다. 

또한 이 특징을 리용하면 프로그람작성자가 가능한껏 많은 처리기 
들을 추가할수 있 으며 보다 많은 계 산능력 을 리용할수 있게 한다. 


실례 프로그람 
C ： 

static char * hosts [] = { 

" sparky ", 

" thud . cs . utk . edu " 

}； 

info = pvm _ addhosts ( hosts , 2, infos ); 

포트란 : 

CALL PVMFADDHOST ( ’ azure’，INFO ) 

오유 

pvm _ addhosts 가 돌려주는 오유코드는 아래 와 같다. 


이름 

PvmBadParam 
Pvm Already 
PvmSysErr 


가능한 경우 
틀린변수값을 지정 
이미 추가되였다. 

국부 pvmd 가 응답하지 않는다. 


infos 의 오유코드는 다음과 같다. 
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이름 

PvmBadParam 

PvmNoHost 

PvmCantStart 

PvmDupHost 

PvmBadVersion 

PvmOutOfRes 


가능한 경우 
처 리기이름이 틀렸다. 

그러한 처 리기 가 없다. 

처 리 기 에 서 pvmd 시 동이 실 패 
처 리기는 이미 구성되 여있다. 

원격 pvmd 의 판본이 일 치하지 않는다. 
PVM 은 체 계 자원 밖에 서 실 행한다. 


pvmfbarrierO 


pvm _ barrier () 


그룹에 있는 모든 프로쎄스들이 자기를 호출할 때까지 호출한 
프로쎄 스를 봉쇄한다. 

문법 

C ： 

int info = pvm _ barrier ( char * group，int count ) 

포트란 : 

call pvmfbarrier ( group , count , info ) 

변수: 

group - 문자렬로 된 그룹이름， 그룹은 존재해야 하며 호출한 
프로쎄스는 이 그룹성 원이 여야 한다. 
count - 그룹성원들을 모두 해방하기전에 pvm _ barrier 를 호출하는 
그룹성 원들의 개수를 지적 하는 옹근수， count 는 대체로 
지 적된 그룹의 전체 성 원들의 개수를 표시 한다. 
info - 이 함수가 되 돌리 는 상태 코드， 오유가 발생하면 령보다 
작다. 

설명 

pvm_barrier 는 그룹에 있는 count 개수의 성원들이 모두 
pvm _ barrier 를 호출할 때 까지 호출한 프로쎄 스를 봉쇄 한다. 다른 
프로쎄스들이 pvm_barrier 를 호출한 다음에 프로쎄스들이 주어진 
그룹에 결합할수 있기때문에 count 변수가 요구된다. 
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따라서 병 렬가상기계는 몇 개의 그룹성 원들이 기 다리 고있는가를 알지 
못한다. count 는 좀 작게 설정할수 있어 도 일 반적 으로는 전체 그룹성 원 
들의 개 수를 지 적 한다. 따라서 pvm _ barrier 호출의 론리 적 인 기 능은 
그룹동기 화를 지 원하는것 이 다. 

어떤 시 점 에서 장벽 연산에 협 력 하는 모든 성 원들은 같은 count 
값으로 이 함수를 호출해 야 한다. 일 단 주어 진 장벽연산이 성 공하면 
같은 그룹이름을 가지고 같은 그룹에서 다시 호출할수 있다. 특수한 
경 우에 count 가 1이 면 병 렬 가상기계 는 pvm _ gsize () 의 값을 리용한다 
(즉 모든 그룹성 원들) . 이 경 우는 그룹들을 창조하고 실행기 간에 는 그 
그룹이 변하지 않는 경우에 쓸모가 있다. pvm _ barrier 는 성공하면 
info 는 0으로 된다. 오유가 생기면 info < 0으로 된다. 


실례프로그람 
C ： 

inum = pvm_joingroup ( " worker " ); 


info = pvm _ barrier ( " worker ", 5 ); 

포트란: 

CALL PVMFJOINGROUP ( " shakers ", INUM ) 
COUNT = 10 


CALL PVMFBARRIER ( " shakers ", COUNT , 

INFO ) 

오유 

pvm _ barrier 가 돌려주는 오유들은 다음과 같다. 


이름 

PvmSysErr 

PvmBadParam 

PvmNoGroup 


가능한 경우 

pvmd 가 시동하지 않았거 나 파괴되 였다. 
count < 1이 다. 

존재하지 않는 그롭이 름을 주었 다. 


PvmNotlnGroup 호출프로쎄 스는 주어 진 그롭성 원이 아니 다. 
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pvmfbcastO pvm _ bcast () 

능동통보완충기에 있는 자료를 방송한다. 

문법 

C ： 

int info = pvm _ bcast ( char * group , int msgtag ) 

포트란 : 

call pvmfbeast ( group , msgtag , info ) 

변수: 

group ■- 현존 그룹의 그룹이 름 

msgtag - 리 용자가 준 옹근수 통보표적 ， msgtag >= 0이 여 야 한다. 

이 것은 리용자프로그람이 여 러 가지 종류의 통보들을 
구별할수 있게 한다. 

info - 이 함수가 돌려주는 옹근수 상태 코드， 오유인 경 우 
귀환값은 0보다 작다. 

설명 

pvm _ bcast 는 능동동보완중기에 있는 모든 동보들을 그롭에 있는 
모든 성원들에게 방송한다. PVM 3. 2에서 방송통보는 송신자에게 
돌아오지 않는다. 임의의 병렬가상기계과제도 pvm _ bcast () 를 호출할수 
있으며 그룹의 성원이 아니라도 된다. 통보의 내용은 msgtag 에 따라 
구별된 다. pvm _ bcast 가 성 공하면 info > 0이 며 오유가 발생 하면 info 
< 0으로 된다. pvm _ bcast 는 비 동기함수이다. 

송신측에서 연산은 통보가 수신프로쎄스에 안전하게 도착한다면 즉시 
회복된다. 이 절차는 수신측에서 정확히 자료를 접수할 때까지 

송신측에 서 의 연산이 중지 되 는 동기 식 통신과는 완전히 대 조적 이 다. 

pvm _ bcast 는 먼저 그롭자료기지들을 검사하여 그롭성 원들의 요년들을 
결정 한다. 이 tid 들에 대 하여 다중통신이 진행 된다. 만일 그룹이 

방송통신기간에 변경된다고 해도 이 변경은 방송통신에 영향을 주지 
않는다. 


실례프로그람 


5 




c ： 


info = pvm _ initsend ( PvmDataRaw ); 
info = pvm _ pkint ( array , 10, 1 ); 
msgtag = 5； 

info = pvm _ bcast ( " worker ", msgtag ); 

포트란 : 

CALL PVMFINITSEND ( PVMDEFAULT ) 

CALL PVMFPKFLOAT ( DATA , 100, 1, INFO ) 
CALL PVMFBCAST ( ’ worker ’， 5 ， INFO ) 


오유 

pvm _ bcast 는 다음의 오유를 되돌린다. 


이름 

PvmSysErr 

PvmBadParam 

PvmNoGroup 


가능한 경우 

pvmd 가 기동하지 않았거 나 파괴되 였다. 
허용되지 않은 msgtag 
존재 하지 않는 그롭 이 름 


pvmfbufinfoO 


pvm _ bufinfo () 


요구한 통보완중기의 정보를 돌려 준다. 

문법 
C : 

int info = pvm_bufinfo ( int bufid , int * bytes , 

int * msgtag , int *tid ) 

포트란 : 

call pvmfbufinfo ( bufid , bytes , msgtag , 社 d , info ) 


변수 

bufid — 구체 적 인 통보완중기 식 별 자를 지 적 하는 옹근수 

bytes - 전체 통보에 대하여 바이트단위로 길이를 돌려주는 옹근수 

msgtag — 통보표적 을 돌려 주는 옹근수 
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tid — 통보의 원전지 를 가리키 는 옹근수 

info - 함수가 돌려주는 옹근수 상태코드，령보다 작은 값은 오유를 
표시 한다. 

설명 

pvm _ bufinfo 는 요구한 동보완중기 의 정 보를 돌려 준다. 이 함수는 
제 일 마지 막에 접 수한 통보의 크기 나 원천을 알려준다. pvm _ bufinfo 는 
응용프로그람이 오는 통보를 접수할수 있을 때 특히 쓸모가 있다. 이때 
그의 원천 tid 나 제 일 처 음에 도착한 통보와 련관되 여있는 msgtag 에 
따라 다음 동작이 진행된다. pvm _ bufinfo 가 정상으로 완료하면 info 는 
0으로 된 다. 만일 오유가 발생하면 info < 0일 것 이 다. 

실례프로그람 
C ： 

bufid = pvm _ recv ( -1， -1 ); 

info = pvm _ bufinfo ( bufid , Sbytes , Stype , Ssource ); 

포트란 : 

CALL PVMFRECV ( -1，-1 ，BUFID ) 

CALL PVMFBUFINFO ( BUFID , BYTES , TYPE , 

SOURCE , INFO ) 

오유들 

pvm _ bufinfo 가 돌려주는 오유코드들은 다음과 같다. 

이름 가능한 경우 

PvmNoSuchBuf 지 적된 완충기 가 존재 하지 않는다. 
PvmBadParam 틀린 변수 

pvmfcatchoutO _ pvm _ catchout () 

자식 과제 들의 출구를 입 력한다. 
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문법 

c ： 

ttinclude < stdio . h > 

int bufid = pvm _ catchout ( FILE * 打 ) 

포트란: 

call pvmfcatchout ( onoff ) 

변수 

打 - 수집한 출구자료들을 써 넣을 파일서술자 

onoff - 옹근수변수， 출구집합을 on 혹은 o 打 하겠는가를 

지 적 한다. 

설명 

pvm_catchout 는 이 함수를 호출한 과제가 이후부터 새롭게 창조한 
자식과제들의 표준출구를 받게 한다. 자식과제들이 표준출구나 표준오유 
출구에 보낸 문자들은 pvmd 들이 수집하고 다음에 이것을 조종통보로 
어 미 과제 에 보내 준다. 자식 과제 가 PvmOutputTid 를 재 설정하지 않는 
다면 손자파제 들이 내 보내 는 줄구도 수집 한다. 

출구의 매 행은 아래와 같은 형식을 가전다. 

[ txxxxx ] BEGIN 

[ txxxxx ] (자식과제로부터 본문) 

[ txxxxx ] END 

매 과제의 출구는 한개의 BEGIN 행과 한개의 END 행을 포함하며 그 
사이 에 과제 의 줄구내 용을 포함하고있 다. C 에 서 는 줄구파일서 술자를 
지 적할수 있 다. 포트란에 서 는 on 혹은 off 로 출구집 합을 바물수 있으며 
결과는 어미과제의 표준줄구에 등록된다. 줄구집합이 유효할 때 
pvm_exit 를 호출하면 그들모두의 출구를 인쇄할수 있도록 통보를 
보내는 과제들이 완료할 때까지 봉쇄된다. 이것을 없애자면 프로그람 
작성 자는 pvm_exit 를 호출하기 전에 pvm _ catchout (0) 을 호출하여 출구 
집합을 o 打로 하여야 한다. pvm _ catchout ( l ) 는 항상 PvmOk 를 돌려 
준다. 
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실례프로그람 
C ： 

^include < stdio . h > 
pvm_catchout ( stdout ); 

포트란: 

CALL PVMFCATCHOUT ( 1 ) 

오유 

pvm _ catchout 는 오유를 돌려주지 않는다. 
pvmfconfigO pvm _ config () 


현재 가상기계 구성 에 대 한 정보를 돌려 준다. 

문법 

C ： 

int info = pvm _ config ( int * nhost , int * narch , 

struct pvmhostinfo **hostp ) 
struct pvmhostinfo { 

int hi _ 社 d ; 
char * hi _ name ； 
char * hi _ arch : 
int hi _ speed ; 

} hostp ； 

포트란: 

call pvmfconfig ( nhost , narch , dtid , 

name , arch , speed , info ) 

변수 

nhost - 가상기계에 있는 처리기들의 개수를 돌려주는 옹근수 
narch - 몇 개의 자료변환형 식 이 리 용되는가를 지 적 하는 옹근수 
hostp - pvmd 의 과제 id , 이름，구성 방식，상대속도를 포함하여 매 
처리기들에 대한 정보를 가지고있는 구조체배렬에로의 
지적자 

dtid - 처리기에 있는 pvmd 의 과제 id 를 돌려준다. 
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name - 처리기의 이름문자렬 

arch - 처 리 기 의 구성 방식 이 롬을 돌려 주는 문자렬 

speed - 처리기의 상대속도를 돌려주는 옹근수，기정값은 1 000 

info - 귀 환값，령 보다 작으면 오유를 표시한다. 

설명 

pvm _ config 는 현재 가상기 계 에 대 한 정 보를 돌려 준다. 정 보는 
조작탁지령 con f 으로 얻는 값과 같다. C 함수는 한번의 호출로 전체 
가상기계에 대한 정보를 얻는다. 포트란함수로는 한번의 호출로 한개의 
처리기에 대한 정보를 얻으며 모든 처리기들에 대한 정보를 얻자면 
처리기의 개수만큼 함수를 반복호출해야 한다. 

pvm _ config 가 성과적으로 완료하면 info = 0으로 되며 오유가 
발생 하면 info < 0이 다. 

실례프로그람 
C ： 

info = pvm _ config ( Snhost , Snarch , Shostp ); 

포트란: 

Do i = l , NHOST 

CALL PVMFCONFIG ( NHOST , NARCH , DT ID ( I ), 
HOST ( i ), ARCH ( i ), SPEED ( i ), INFO ) 

Enddo 

오유 

pvm _ config 는 다음과 같은 오유를 돌려준다. 

이름 가능한 경우 

PvmSysErr pvmd 가 응답하지 않는다. 


pvmfdelhostO pvm _ delhosts () 

가상기계로부터 한개 혹은 몇개의 처 리기들을 삭제한다. 
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문법 

c ： 

int info = pvm_delhosts( char **hosts，int 

nhost, int *infos ) 

포트란 : 

call pvmfdelhost( host, info ) 

변수 

hosts - 삭제해야 할 처리기들의 이름들을 포함하고있는 

문자렬들에 로의 지 적 자배 렬 

nhost — 삭제 해 야 할 처 리 기 들의 개 수를 지 적 하는 옹근수 
infos - 이 함수가 돌려주는 개별적인 처리기들에 대한 상태코드를 
포함하고있는 길 이가 nhost 인 배 렬， 오유가 발생하면 
령보다 작은 값이 설정 된다. 

host - 삭제해 야 할 처 리 기의 이 름을 포함하고있는 문자렬 
info •■귀환 상태 코드 ， nhost 보다 작으면 부분오유， 1 보다 작으면 
완전오유를 표시 한다. 


설명 

pvm_delhosts 는 가상기 계 에서 하나이상의 처 리 기 들을 삭제 한다. 
이때 이 처리기들에서 실행하고있던 모든 병렬가상기계프로쎄스들과 
pvmd 는 처 리 기 가 삭제 될 때 제 거 된 다. 

pvm_delhosts 가 성과적으로 완료되면 info=nhost 로 될것 이 다. 

1 <= info < nhost 이 면 부분적 으로 실 패 하였 음을 보여 주며 info < 
1 이 면 완전한 오유가 발생 하였 다는것 을 표시한다. 

배렬 infos 를 검사하여 어느 처리기에서 오유가 일어났는가를 검사 
할수 있 다. 포트란함수 pvmfdelhost 에서는 한번의 호출로 한개의 
처 리기만을 삭제한다. 

어느한 처리기에서 오유가 발생하여도 병렬가상기계체계는 계속 
기 능을 수행하며 이 처 리 기를 자동적 으로 가상기 계 에서 삭제한다. 

웅용프로그람에서는 이때 pvm_notify 를 호출하여 어느 처리기에서 
오유가 생겼는가를 알수 있다. 

이것은 프로그람개발자들이 프로그람의 실행중에 발생하는 오유에 
대하여 오유처 리를 할수 있게 한다. 
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실례프로그람 
C ： 

static char * hosts [] = { 

" sparky ", 

" thud . cs . utk . edu " 

}； 

info = pvm _ delhosts ( hosts , 2 ); 

포트란 : 

CALL PVMFDELHOST ( ’ azure’，INFO ) 

오유: 

이름 가능한 조건 

PvmBadParam 변수값이 틀렸다. 

PvmSysErr 국부 pvmd 가 응답하지 않는다. 

PvmOutOfRes PVM 은 체계의 자원밖에 있다. 

pvmfexitO pvm _ exit () 

이 프로쎄 스를 병 렬 가상기계 에서 삭제할것 을 국부 pvmd 에 통보한다. 

문법 

C ： 

int info = pvm _ exit ( void ) 

포트란 : 

call pvmfexit ( info ) 

변수 

info - 귀환 상태값，오유가 발생 하면 값은 0보다 작다. 

설명 

pvm _ exit 는 프로쎄 스를 병 렬 가상기 계 에 서 삭제 할것 을 국부 pvmd 에 
알려 준다. 모든 병 렬 가상기계프로쎄 스들은 중지하거 나 안전하게 완료 
하려 고 하는 경우 pvm _ exit 를 호출할수 있다. 
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pvm _ spawn 으로 시동되지 않은 프로쎄스들도 이 함수를 호출할수 
있 다. 

실례프로그람 
C ： 

/* Program done */ 
pvm _ exit () ; 
exitO ; 

포트란 : 

CALL PVMFEXIT ( INFO ) 

STOP 

오유: 

이름 가능한 경우 

PvmSysErr pvmd 가 응답하지 않는다. 

pvmffreebuf 0 pvm_freebuf 0 

통보완중기를 해 방한다. 

문법 

C ： 

int info = pvm_freebuf ( int bufid ) 

포트란 : 

call pvmffreebuf ( bufid , info ) 

변수 

bufid - 통보완충기식 별자 

info - 귀환 상태 코드， 오유가 발생 하면 령보다 작은 값이 반환된다. 
설명 

pvm _ freebuf 는 bufid 로 지 적된 통보완충기 와 관련된 기 억기를 
해방한다. 통보완충기들은 pvm _ mkbuf , pvmjnitsend 그리고 
pvm _ recv 에 의해서 창조된다. 
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pvm _ freebuf 는 성 공하면 info =0으로 되 며 오유가 발생 하면 info 
< 0으로 된다. 통보를 보냈거나 또 통보완충기가 더이상 필요없을 때 
pvm_mkbuf 를 호줄하여 창조한 동보완중기들을 해방하는데 
pvm _ freebuf 를 리용한다. 

수신완충기들은 그것들이 다중완충기로서 리용되지 않는 한 일반적 
으로는 해방하지 말아야 한다. 그러나 수신완중기들을 해방하는데도 
pvm _ freebuf 를 리용할수 있다. 

그러므로 도착은 하였지만 어떤 요인으로 더 이상 필요없는 통보들은 
완충기 공간을 소비하지 않도록 없애 버 릴수 있다. 

일반적으로 응용프로그람들에서는 다중송수신완충기가 필요없으며 
간단히 pvmjnitsend 함수를 리용하여 기정의 송신완충기를 재 설정할수 
있 다. 

다중완충기 들이 쓸모있는 경 우도 있다. 실례 로 병 렬 가상기계 를 
리용하는 서고 혹은 시각적대면부들에서와 실행하는 병렬가상기계 
응용프로그람들과 호상작용은 하지만 응용프로그람자체의 통신과는 
간섭하려 고 하지 않는 경 우에 다중완충기 가 효과적 이 다. 

실례프로그람 

C ： 

bufid = pvm_mkbuf ( PvmDataDefault ); 
info = pvm_freebuf ( bufid ); 

포트란: 

CALL PVMFMKBUF ( PVMDEFAULT , BUFID ) 

CALL PVMFFREEBUF ( BUFID , INFO ) 

오유: 

이름 

PvmBadParam 

PvmNoSuchBuf 


가능한 경우 
변수이름이 틀렸다. 

주어 진 완충기 가 무효하다. 


pvmfgetinstO 
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pvm _ getinst () 



병 렬 가상기 계 프로쎄 스그룹에 있는 실 체 들의 개 수를 돌려 준다. 

문법 

C ： 

int inum = pvm _ getinst ( char * group，int tid ) 

포트란 : 

call pvmfgetinst ( group , tid , inum ) 

변수 

group •- 현존 그룹의 그룹이 름 
tid - 병 렬 가상기 계 프로쎄 스의 옹근수과제 식 별 자 

inum - 함수가 돌려 주는 실체 번호，실체 번호들은 0부터 시 작하여 
증가한다，오유가 생기면 0보다 작은 값이 설정된다. 

설명 

pvm _ getinst 는 그룹 이 름 group 와 병 렬 가상기계 의 과제식 별 자를 
주며 입 구에 대 응하는 유일 한 실 체번호를 돌려준다. pvm _ getinst 가 
성공하면 inum >= 0으로 되며 오유가 생기면 inum < 0이다. 

실례프로그람 
C ： 

inum = pvm _ getinst ( " worker ", pvm _ mytid () ); 
inum = pvm _ getinst ( " worker ", tid [ i ] ); 

포트란 : 

CALL PVMFGETINST ( ’ GROUP 3’， TID , INU M ) 

오유: 

이름 가능한 경우 

PvmSysErr pvmd 가 시동되지 않았거나 파괴되였다. 

PvmBadParam 무효한 tid 값 

PvmNoGroup 존재 하지 않는 그롭 이 름 

PvmNotlnGroup tid 가 속하지 않은 그룹을 지 적하였 다. 


pvmfgetoptO 


pvm _ getopt () 




여 러 가지 libpvm 추가선택 들을 보여 준다. 


문법 

C ： 

int val = pvm _ getopt ( int what ) 

포트란: 

call pvmfgetrbuf ( what , val ) 

변수 

what — 무엇 을 얻 겠는가를 정 의 하는 옹근수，주가선택 들은 다음과 
같다. 

추가선택 값 의미 


PvmRoute 1 

PvmDebugMask 2 

PvmAutoErr 3 

PvmOutputTid 4 

PvmOutputCode 5 

PvmTraceTid 6 

PvmTraceCode 7 

PvmFragSize 8 

PvmResvTids 9 


경로규칙 
오유수정 마스크 
자동오유보고 
자식과제의 표준출구 
출구통보표적 
자식과제들의 추적수단 
추적통보표적 
통보의 토막크기 
통보들이 예약된 표적들과 
TID 들에 허용 


val - 추가선택값을 지정하는 옹근수，미 리 정의된 값들은 아래 와 
같다. 

추가선택 값 의미 


PvmDontRoute 1 련결요구하지 않거나 허가하지 

않음 

PvmAllowDirect 2 련결요구하지 않고 허가함 

PvmRouteDirect 3 련결요구하고 허가함 
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설명 

pvm _ getopt 를 리 용하여 리 용자는 병 렬 가상기 계 에 설 정 된 추가선택 
값들을 볼수 있다. 

실례프로그람 

C ： 

route_method = pvm _ getopt ( PvmRoute ); 

포트란: 

CALL PVMFGETOPT ( PVMAUTOERR , VAL ) 

오유 

이름 가능한 경우 

PvmBadParam 변수가 틀렸다. 


pvmfgetrbuf 0 


pvm_getrbuf 0 


능동수신완중기 에 대 한 통보완중기식 별 자를 돌려 준다. 

문법 

C ： 

int bufid = pvm_getrbuf ( void ) 

포트란: 

call pvmfgetrbuf ( bufid ) 

변수 

bufid - 능동수신완충기 에 대 한 통보완충기 식 별 자 
설명 

pvm _ getrbuf 는 능동수신완충기에 대한 통보식별자 bufid 를 돌려 
주든가 현재 완중기 가 없는 경 우에 는 0을 돌려 준다. 

실례프로그람 
C ： 

bufid = pvm_getrbuf 0 : 
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포트란: 


CALL PVMFGETRBUF ( BUFID ) 


오유 

오유 없음 


pvmfgetsbuf 0 pvm_getsbuf 0 


능동수신완중기 에 대 한 통보완중기식 별 자를 돌려 준다. 

문법 

C ： 

int bufid = pvm_getsbuf ( void ) 

포트란: 

call pvmfgetsbuf ( bufid ) 

변수 

bufid - 능동송신완충기 에 대 한 통보완충기 식 별 자 
설명 

pvm _ getsbuf 는 능동송신완충기에 대한 통보식별자 bufid 를 돌려 
주든가 현재 완충기 가 없는 경우에는 0을 돌려준다. 

실례프로그람 
C ： 

bufid = pvm_getsbuf 0 : 

포트란: 

CALL PVMFGETSBUF ( BUFID ) 

오유 

오유 없음 


pvmfgettidO pvm _ gettid () 


그롭이 름파 실체 번호로 지 적된 프로쎄스의 tid 를 돌려 준다. 


문법 
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c ： 

int tid = pvm _ gettid ( char * group，int inum ) 

포트란 : 

call pvmfgetticK group , inum , tid ) 

변수 

group - 현존 그룹의 이름을 가지고있는 문자렬 
inum - 그룹에 있는 프로쎄스의 실체개수 
tid - 귀 환된 옹근수식 별 자 


설명 

pvm _ gettid 는 그룹이 름 group 와 실체번호 inum 으로 
프로쎄 스의 tid 를 돌려준다. pvm _ gettid 는 성 공하면 tid > 0, 
생기면 tid < 0이다. 

실례프로그람 
C ： 

tid = pvm _ gettid (" worker ", 0) : 

포트란 : 

CALL PVMFGETTICK ’ worker ’， 5， TID ) 

오유: 


이름 

PvmSysErr 

PvmBadParam 

PvmNoGroup 

PvmNoInst 


가능한 경우 

국부 pvmd 에 접촉할수 없다. 
변수가 틀렸다. 

그러한 그룹이 존재하지 않는다. 
그룹에 그러한 실체 가 없다. 


pvmfgsizeO 


pvm _ gsize () 


그룹에 현재 있는 성원들의 개수를 돌려준다. 


지적된 

오유가 


문법 

C ： 
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int size = pvm _ gsize ( char *group ) 

포트란 : 

call pvmfgsize ( group , size ) 

변수 

group - 현존 그룹의 그룹이름문자렬 

size - 현재 그룹에 있는 성원들의 개수，오유가 생기면 0보다 작은 
값을 돌려준다. 

설명 

pvm _ gsize 는 group 라는 이름을 가진 그룹의 크기를 돌려 준다. 
오유가 생기면 size < 0 으로 된다. 

병렬가상기계체계에서 그룹들은 동적으로 변하므로 이 함수는 주어진 
그룹의 현재 크기 만을 돌려준다. 

실례프로그람 
C ： 

size = pvm _ gsize ( " worker " ) ； 

포트란 : 

CALL PVMFGSIZE ( ’ group 2 ’，SIZE ) 

오유 

이름 가능한 경우 

PvmSysErr pvmd 가 시동하지 않았거나 파피되였다. 

PvmBadParam 그룹이름이 틀렸다. 

pvmfhalt pvm _ halt () 

병 렬 가상기 계 체 계 전 체 를 중지 한다. 

문법 

C ： 

int info = pvm _ halt ( void ) 

포트란 : 

call pvmfhalt ( info ) 
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변수 

info - 오유상태 를 돌려주는 옹근수 
설명 

pvm _ halt 는 원격과제들，원격 pvmd ， 국부과제들(이 명령을 호출한 
과제도 포함)，국부 pvmd 를 포함한 병 렬가상기계체계 전체를 중지한다. 

오유: 

이름 가능한 경우 

PvmSysErr 국부 pvmd 가 응답하지 않는다. 

pvmfhostsyncO p vm_hostsync 0 


병렬가상기계체계로부터 날자, 시간을 얻는다. 

문법 

C ： 

^include < sys / time . h > 

int info = pvm _ hostsync ( int host , struct timeval 

* clk , struct timeval *delta ) 

포트란: 

call pvmfhostsync ( host , clksec , clkusec , 

deltasec , deltausec , info ) 

변수 

host - 처 리 기 의 TID 

elk , clksec , clkusec - 처 리기로부터 표준시 간을 돌려준다. 

Delta , deltasec , deltausec - 국부시계와 원격시계와의 편차값을 

돌려 준다. 

설명 

pvm _ hostsync () 는 가상기계에 있는 처리기의 시계를 표준화하고 
원격시계와 국부시계와의 편차를 돌려준다. 
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통보전송으로 인한 델타오유를 줄이기 위하여 원격시계를 읽기전과 
읽은 후에 국부시계의 표본들을 얻는다. 델타시간은 부의 값을 가전다. 
마이크로초마당은 항상 0-999 999까지의 값을 가지며 초마당의 부호는 
델타의 부호를 가전다. 

C 에 서 elk 나 delta 가 빈 지 적자로 입 력 되 면 이 변수는 귀 환하지 
않는다. 

오유: 

이름 

PvmSysErr 
PvmNoHost 
PvmHostFail 

pvmfinitsendO 


가능한 경우 

국부 pvmd 가 응답하지 않는다. 

그런 처리기가 없다. 

처리기에 접근할수 없다. 

pvm _ initsend () 


기정의 송신완중기를 지우고 통보부호화를 지정한다. 


문법 

C ： 

int bufid = pvm_initsend ( int encoding ) 

포트란: 

call pvmfinitsend ( encoding , bufid ) 

변수 

encoding - 다음 통보의 부호화수법 을 지 적 하는 옹근수 
C 에는 다음과 같은 추가선택들이 있다. 


부호화 값 

PvmDataDefault 0 

PvmDataRaw 1 

PvmDatalnPlace 2 


의미 

XDR 

부호화를 하지 않는다. 
자료를 왼쪽에 배 치 한다. 


bufid - 통보완충기식 별 자，오유가 발생한 경 우 0보다 작은 값이 
설정된다. 


22 


설명 

pvm _ initsend 는 송신완충기 를 지 우고 새 로운 통보를 압축하기 위한 
준비 를 한다. 이 자료압축에 서 리용되 는 부호화수법 은 encoding 에 
의하여 설정 된다. 

XDR 부호화는 기 정 으로 리 용된 다. 그 리유는 병 렬 가상기계 는 이 
통보를 보내기전에 리용자가 이종의 처리기를 새롭게 첨부하였는지 
모르기 때 문이 다. 

만일 리용자가 통보를 보내 는 처 리 기의 자료변환형 식 이 목적처 리 기의 
자료변환형식과 같다는것을 알고있다면 PvmDataRaw 부호화를 리용 
하여 부호화비용을 줄일수 있다. 

PvmDatalnPlace 부호화는 압축할 때에 자료가 왼쪽에 배치 된다 
는것 을 지 적 한다. 통보완중기 는 보낼 항목들에 대 한 지 적 자와 크기 만을 
가지고있 다. 

pvm _ send 를 호출하면 항목들은 리 용자의 기 억 기 밖으로 직 접 복사 
된다. 이 추가선택은 통보를 복사하는 회수를 줄일수 있다. 

PvmDatalnPlace 추가선택 은 PVM 3. 2에 서 는 리용할수 없 다. 

pvm _ initsend 가 성공적으로 완료하면 bufid 는 통보완충기의 식별자 
를 포함한다. 오유가 일어 나면 bufid < 0으로 된다. 

실례프로그람 

C ： 

bufid = pvm_initsend ( PvmDataDefault ); 
info = pvm _ pkint ( array , 10, 1 ); 
msgtag = 3 ; 

info = pvm _ send ( tid , msgtag ); 

포트란: 

CALL PVMFINITSEND ( PVMRAW , BUFID ) 

CALL PVMFPACK ( REAL 4, DATA , 100, 1, INFO ) 

CALL PVMFSEND ( TID , 3, INFO ) 

오유: 

이름 가능한 경우 

PvmBadParam 무효한 부호화 
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PvmNoMem 


malloc 가 실패，완충기를 창조할수 있는 
기억기가 부족 


pvmfjoingroup 0 pvm_joingroup 0 

주어 진 그룹에 호출한 프로쎄 스를 기 입한다. 

문법 

C ： 

int inum = pvm_joingroup ( char *group ) 

포트란: 

call pvmfjoingroup ( group , inum ) 

변수 

group - 현존 그룹의 그룹이름 

inum - 이 함수가 되 돌리 는 옹근수실 체번호，실 체번호들은 0부터 

시작하여 증가한다. 오유가 생기면 0보다 작은 값이 

설정된다. 

설명 

pvm _ joingroup 는 group 라는 이름을 가진 그룹에 호출한 과제를 
등록하며 그룹에서 이 과제 의 실체번호 inum 을 돌려준다. 

만일 오유가 생 기면 inum <0으로 된다. 그룹들을 리용할 때 
( group , inum ) 쌍은 병 렬 가상기계프로쎄 스들을 유일 하게 식 별 한다. 
이 것은 이 전의 병 렬가상기 계 이 름달기수법과 일 치 한다. 만일 과제 가 
pvm_lvgroup 을 호출하여 이 그룹을 떠났다가 같은 그룹에 다시 
결 합하면 이 때 과제 가 같은 실 체번호를 가지 게 된다는것 을 담보하지 
않는다. 

병 렬 가상기계 는 낡은 실체번호들을 다시 리용하려 고 하므로 과제 가 
그룹에 결 합할 때 과제 는 가능한 실체번호들중에 서 제 일 작은 값을 
가지게 된다. 

병 렬 가상기계 에서 과제 는 동시 에 여 러 그룹들의 성 원으로 될수 있다. 

실례프로그람 

C ： 

inum = pvm_joingroup ( " worker " ); 
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포트란: 


CALL PVMFJOINGROUP ( ’ group 2 ’，INUM ) 


오유: 

이름 

PvmSysErr 

PvmBadParam 

PvmDupGroup 


가능한 경우 

pvmd 는 시동하지 않았거 나 파괴되 였다. 
빈 그롭이름이 지적되였다. 

이 미 그룹에 결 합되 여있 다. 


pvmfkillO 


pvm _ kill () 


지 적된 병 렬가상기계프로쎄스들을 중지한다. 

문법 

C ： 

int info = pvm _ kill ( int tid ) 

포트란: 

call pvmfkilK tid , info ) 

변수 

tid - 중지 해 야 할 병 렬 가상기 계 프로쎄 스의 과제 식 별 자 

info - 귀 환된 상태코드，오유가 발생하면 0보다 작은 값이 설정 된다. 

설명 

pvm _ kill 은 tid 로 지 적된 병 렬가상기계프로쎄스에 중지신호 
( SIGTERM ) 을 보낸다. 다중처리기들인 경우에는 처리기들을 중지하기 
위 하여 처 리 기 에 의 존하는 방법 들로 교체 된 다. 

pvm _ kill 이 성과적으로 완료하면 info = 0으로 되며 오유가 발생 
하면 info < 0으로 된 다. pvm _ kill 은 호출한 프로쎄 스는 중지 하지 
않는다. 

자기 자신을 중지 하려 면 C 에 서 는 pvm _ exit () 를 호줄하고 다음에 
exitO 를 호출한다. 포트란에서는 pvmfexit 를 호출하고 다음에 stop 를 
호출한다. 


실례프로그람 
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c ： 

info = pvm_kill ( 吐 d ) ； 

포트란 : 

CALL PVMFKILL ( TID , INFO ) 


오유: 

이름 

PvmBadParam 

PvmSysErr 


가능한 경우 
틀린 tid 값을 주었다. 
pvmd 가 응답하지 않는다. 


pvmflvgroupO 


pvm _ lvgroup () 


호출한 프로쎄 스를 그룹에 서 삭제한다. 

문법 

C ： 

int info = pvm _ lvgroup ( char *group ) 

포트란 : 

call pvmflvgroup ( group , info ) 

변수: 

group - 현존 그룹의 그룹이름 

info - 상태코드，오유가 발생하면 0보다 작은 값이 설정 된다. 

설명 

pvm _ lvgroup 은 그룹 group 로부터 호출한 프로쎄 스를 삭제한다. 
오유가 발생하면 info <0으로 된 다. 

만일 프로쎄스가 pvm _ lvgroup 나 pvm _ exit 를 호출하여 그룹에서 
떠났다가 후에 다시 같은 그룹에 결합하면 새로운 실체번호가 그 
프로쎄스에 분배된다. 

낡은 실 체번호들은 pvm _ joingroup 를 호출한 프로쎄 스에 다시 
분배된다. 


실례프로그람 
C ： 
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포트란: 


info = pvm _ lvgroup ( " worker " ); 


CALL PVMFLVGROUP ( ’ group 2 ’，INFO ) 


오유: 

이름 

PvmSysErr 

PvmBadParam 

PvmNoGroup 

PvmNotlnGroup 


가능한 경우 

pvmd 가 응답하지 않는다. 

빈 그룹이 름을 지 적하였 다. 

존재하지 않는 그룹이 름을 지 적하였 다. 

이 프로쎄스는 이미 그룹에서 삭제되였다. 


pvmfmcastO 


pvm _ mcast () 


능동통보완중기에 있는 자료를 과제들의 모임에 다중통신한다. 

문법 

C ： 

int info = pvm _ mcast ( int * tids , int ntask , int 

msgtag ) 

포트란: 

call pvmfmcast ( ntask , 吐 ds , msgtag , info ) 

변수 

ntask - 통보를 보내 야 할 과제 들의 개 수를 지 적 하는 옹근수 
tids - 통보를 보내야 할 과제들의 과제 ID 들을 포함하고있는 적어도 
ntask 길 이 를 가진 옹근수배 렬 

msgtag - 리 용자가 제 공한 통보표적， msgtag >= 0이 여 야 한다. 
info - 상태코드，오유가 생기면 0보다 작은 값이 설정된다. 

설명 

pvm _ mcast 는 능동송신완충기에 보관된 통보들을 tids 배렬에 지적된 
ntask 개의 과제들에 다중통신한다. 

이 통보는 호출자의 切선가 tids 배 렬에 있다 해도 호출자에게는 보내지 
않는다. 통보의 내용은 msgtag 로 구분할수 있다. 
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pvm _ mcast 가 성 과적 으로 완료하면 info > 0이 며 오유가 발생 하면 
info < 0으로 된다. 수신프로쎄스는 pvm _ recv 나 pvm _ nrecv 를 호출 
하여 다중통신에서 자기 부분만을 수신할수 있다. 통보가 수신프로 
쎄스에 안전하게 도착하자마자 송신프로쎄스는 자기처 리를 계속한다. 

이것은 수신프로쎄스가 통보를 정확히 접수하였다는것을 확인할 
때 까지 송신처 리 기 에 서 의 계 산이 중지하는 동기식 통신과는 대 조적 이 다. 

pvm _ mcast 는 지적한 과제들이 실행하는 pvmd 들을 결정한다. 그 
다음 통보들을 이 pvmd 들에 넘긴다. 다음 pvmd 들은 이 통보들을 
국부파제 들에 분배 한다. 대 다수의 다중처 리 기 제 작자들은 다중통신을 
지원하지 않는다. 

일반적으로는 다중처리기에 있는 모든 리용자프로쎄스들에 
방송통신을 제공한다. 이러한 제한성으로 하여 pvm_mcast 는 모든 
병렬가상기계프로쎄스들에 방송하는 득수한 경우를 제외하고는 다중 
처리기들에서 효과적인 통신수법으로 되지 못한다. 


실례프로그람 
C ： 

info = pvm _ initsend ( PvmDataRaw ); 
info = pvm _ pkint ( array , 10, 1 ); 
msgtag = 5 ; 

info = pvm _ mcast ( tids , ntask , msgtag ); 

포트란: 


CALL PVMFINITSEND ( PVMDEFAULT ) 


CALL PVMFPACK ( REAL 4, DATA , 100, 1, 

INFO ) 

CALL PVMFMCAST ( NPROC , TIDS , 5, INFO ) 


오유: 

이름 

PvmBadParam 

PvmSysErr 

PvmNoBuf 


가능한 경우 
msgtag < 0 이 다. 
pvmd 가 응답하지 않는다. 
송신완충기가 없다. 


pvmfmkbuf 0 
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pvm_mkbuf 0 



새로운 송신 완중기를 장조한다. 


문법 

C ： 

int bufid = pvm_mkbuf ( int encoding ) 

포트란: 

call pvmfmkbuf ( encoding , bufid ) 

변수 

encoding - 완충기 의 부호화수법 을 지 적한다. 

C 에는 다음의 추가선택들이 있다. 

부호 값 

PvmDataDefault 0 

PvmDataRaw 1 

PvmDatalnPlace 2 


의미 

XDR 

부호화를 하지 않는다. 
왼쪽자료배치 


bufid - 귀환된 통보완충기식 별자，오유가 생기면 0보다 작은값이 
설정된다. 

설명 

pvm _ mkbuf 는 새로운 통보완충기를 창조하며 그의 부호화상태를 
encoding 으로 설 정한다. pvm _ mkbuf 가 성 과적 으로 완료하면 bufid 는 
새로운 완충기에 대한 식별자로 되며 오유가 생기면 bufid < 0로 된다. 
기정 으로는 XDR 부호화가 리용된다. 비록 체계 가 이종이라고 해도 
리용자가 가상기계에 대한 지식을 얻을수 있도록 여러가지 부호화 
추가선택들이 리용된다. 

실례로 다음에 통보를 보낼 목적처리기에서 리용하는 자료변환 
형 식 이 원 천 처 리 기 의 자료변환형 식 과 같다는것 을 리 용자가 사전에 
알고있다면 PvmDataRaw 부호화를 리용하여 부호화로 인한 비용을 줄 
일수 있다. 

PvmDatalnPlace 부호화방법을 리 용하면 압축시에 자료를 왼쪽 
에 서 부터 배 치할수 있 다. 통보완충기 는 다만 보내 야 할 항목들의 크기 
와 지 적 자만을 보관하고있다. 
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pvm_send 를 호출할 때 항목들은 리용자의 기 억 기밖으로 직 접 
복사된다. 이 추가선택은 통보를 복사하는 회수를 줄인다. PvmDataln 
Place 는 PVM 3. 2 에서는 실현할수 없다. 

리 용자가 다중통보완중기 들을 리 용하려 고 한다면 pvm_mkbuf 를 
pvm_freebuf 와 함께 리용할수 있다. 통보가 전송되고 통보완충기가 
더 이상 필요없으면 pvm_freebuf 를 써서 송신완충기를 해 방한다. 

수신완충기들은 pvm_recv 와 pvm_nrecv 를 리용하면 자동적으로 
창조된다 . 리용자들은 완충기를 해방하기전에 pvm_setrbuf 를 리용하여 
확보하여 야 한다 . 

일 반적 으로 다중송수신 완충기 들은 필 요없 다. 리 용자들은 

pvmjnitsend 를 리 용하여 기 정 의 송신완충기 들을 재 설 정 한다. 

다중완충기 들이 쓸모있는 경우도 있다. 

실례로 병렬가상기계를 리용하는 서고 혹은 시각대면부들에서와 
실 행하는 병 렬 가상기계응용프로그람들과 호상작용하지 만 응용프로그람 
자체 의 통신과는 간섭하려 고 하지 않는 경 우에 다중완충기 가 효과적 이 다. 

다중완충기들을 리용할 때 일반적으로 압축하는 매개 통보들에 
대하여 완충기들이 설정된다. 

실례프로그람 

C ： 

bufid = pvm_mkbuf( PvmDataRaw ); 

/* send the message */ 
info = pvm_freebuf ( bufid ); 

포트란 : 

CALL PVMFMKBUF(PVMDEFAULT, MBUF) 

* SEND MESSAGE HERE 

CALL PVMFFREEBUF( MBUF, INFO ) 

오유: 

이름 가능한 경우 

PvmBadParam 무효한 부호화 값 

PvmNoMem malloc 가 실패하였 다. 


pvmfmstatO 
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pvm_mstat() 



가상기계에 있는 처리기의 상태를 돌려준다. 


문법 
C ： 

int mstat = pvm _ mstat ( char *host ) 

포트란 : 

call pvmfmstat ( host , mstat ) 

변수 

host - 처 리 기 이 름을 가지 고있는 문자렬 
mstat - 가상기 계 의 상태 : 

값 

PvmOk 
PvmNoHost 
PvmHostFail 

설명 

pvm_mstat 는 실행하고있는 병렬가상기계프로쎄스와 관련한 처리기 
host 의 상태 mstat 를 돌려준다. 이 함수를 리용하여 어느 처리기가 
실 패 하였는가, 가상기 계 를 재 구성 할 필 요는 없는가를 검 사할수 있 다. 


의미 

성공 

가상기계에 그 처리기가 없다. 
처 리 기 에 접 근 불가능 


실례프로그람 
C ： 

mstat = pvm _ mstat ( " msr . ornl . gov " ); 

포트란 : 

CALL PVMFMSTAT ( ‘ msr . ornl . gov’，MSTAT ) 


오유: 

이름 

PvmSysErr 

PvmNoHost 

PvmHostFail 


가능한 경우 

pvmd 가 응답하지 않는다. 

•乂 J ■기계에 이 처리기^4 없다. 
처 리 기 접 근불가능 
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pvmfmytidO 


pvm _ mytid () 


프로쎄스의 tid 를 돌려준다. 

문법 

C ： 

int tid = pvm _ mytid ( void ) 

포트란 : 

call pvmfmy 吐 d ( tid ) 

변수 

tid - 호출한 병 렬 가상기계프로쎄 스의 옹근수식별 자를 돌려준다. 
오유가 발생하면 0보다 작은 값이 설정 된다. 


설명 

이 함수를 처음 호출하면 먼저 이 프로쎄스를 병렬가상기계에 
등록하며 이 프로쎄 스가 pvm _ spawn 에 의 해 창조된것 이 아니 라면 
유일 한 tid 를 생 성 한다. 

pvm _ mytid 는 호출한 프로쎄스의 tid 를 돌리며 응용프로그람내에서 
여 러번 호출할수 있다. 

만일 이 함수를 호출하기전에 과제가 체계에 등록되여있지 않다면 
임의의 병렬가상기계체계호출로 과제를 등록할수 있다. 

tid 는 국부 pvmd 가 창조하는 32 bit 정의옹근수이다. 32 bit 구역은 
가상기계에서의 그의 위 치 ( pvmd 의 주소)，프로쎄스가 다중처 리기에서 
실 행하는 경 우 CPU 번호，프로쎄 스 id 마당과 같은 여 러 가지 정 보들을 
가지는 마당으로 갈라진다. 이 정 보는 병 렬가상기계 에서만 리용하며 
응용프로그람에 서 는 리용할수 없 다. 만일 응용프로그람이 pvm _ mytid 를 
호출하기전에 병 렬 가상기계 가 시 동하지 않았으면 tid <0 으로 된 다. 

실례프로그람 

C ： 

tid = pvm _ mytid ( ) ； 

포트란 : 

CALL PVMFMYTID ( TID ) 
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오유: 


이름 가능한 경우 

PvmSysErr pvmd 가 응답하지 않는다. 

pvmfncrtifyO pvm_notify 0 


처 리 기 의 실 패 와 같은 병 렬 가상기 계 사건들을 통지 할것 을 요구한다. 

문법 

C ： 

int info = pvm_notify ( int what , int msgtag , 

int cnt , int *tids ) 

포트란: 

call pvmfnotify ( what , msgtag , cnt , tids , info ) 

변수 

what - 통지할 사건을 지 적하는 옹근수 
다음의 추가선택들이 있다. 


값 

PvmTaskExit 

PvmHostDelete 

PvmHostAdd 


의미 

통지 가 없 다. 

처 리 기를삭제 하면 통지 한다. 

처 리 기를 추가하면 통지한다. 


msgtag - 통지 에 리 용되 는 통보표적 

cnt - PvmTaskExit 와 PvmHostDelete 를 위한 tids 배 렬의 길 이를 
지정 하는 옹근수， PvmHostAdd 에 대 해서 는 동지회수를 
지 적 한다. 

tids - 통지 할 과제 목록 혹은 pvmd 의 tid 들을 가지고있는 길이가 
ntasks 인 옹근수배 렬， PvmHostAdd 추가선택 인 경 우에 는 
이것이 빈 배렬로 된다. 

info - 귀환 상태값, 오유가 생기면 0보다 작은 값이 설정된다. 
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설명 

pvm _ notify 는 병 렬 가상기계 가 어 떤 사건을 검 출한 경 우에 이 
함수를 호줄한 프로쎄 스에 통지할것 을 요구한다. 

통지요구에 응답하여 병 렬가상기계는 몇개의 통보들을 호출한 
파제 에 보낸 다. 통보들에 는 이 통보들이 통지 문이 라는것 을 표시 하는 
표적 을 붙인 다. tids 배 렬 은 TaskExit 나 HostDelete 를 리용할 때 누가 
이 것을 조종하는가를 지 적한다. 

HostAdd 를 리용할 때 는 아무것 도 요구하지 않는다. 만일 요구하면 
pvm _ config 와 pvm _ tasks 를 리 용하여 과제 와 pvmd 의 id 를 얻 을수 
있다. 통지문 통보들은 다음의 형식을 가지고있다. 

PvmTaskExit - 매 tid 에 대하여 한개의 통지문 통보가 요구된다. 

통보본체는 완료된 과제의 단일한 tid 를 

가지고있 다. 

PvmHostDelete - 매 tid 에 대 하여 한개의 통지문 통보가 요구된다. 

통보체는 완료된 pvmd 의 단일한 tid 를 

가지고있 다. 

PvmHostAdd - cnt 개수까지의 통보들을 보낸다. 통보는 옹근수 
count 를 포함하며 다음에 새 로운 pvmd 들에 대 한 
tids 목록을 가지고있다. 

나머지 PvmHostAdd 통보들의 계수기는 다음 
pvm _ notify 를 호출하여 갱신한다. 

통지문 통보들에 있는 tids 들은 옹근수로 압축한다. 호출한 과제들은 
지적한 msgtag 를 가진 동보들을 수신하고 그에 따르는 처 리를 진행할수 
있 다. 

실례프로그람 

C ： 

info = pvm _ notify ( PvmHostAdd , 9999, 1, dummy ); 

포트란: 

CALL PVMFNOTIFY ( PVMHOSTDELETE , 1111, 

NPROC , TIDS , INFO ) 
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오유: 

이름 

PvmSysErr 

PvmBadParam 


가능한 경우 

pvmd 가 응답지 않는다. 
무효한 변수값 


pvmfnrecvO 


pvm _ nrecv () 


msgtag 라는 표식 을 가진 비봉쇄 통보가 있는가를 검 사한다. 

문법 

C ： 

int bufid = pvm _ nrecv ( int tid , int msgtag ) 

포트란: 

call pvmfnrecv ( tid , msgtag , bufid ) 

변수 

tid - 리용자가 준 송신프로쎄스의 과제식별자 (-1 은 임의의 
과제 임 을 표시한다. ) 

msgtag - 리 용자가 준 통보표적， msgtag >= 0이 여 야 한다. 
bufid - 새로운 능동수신완충기의 식별자를 돌리는 옹근수，오유가 
발생하면 0보다 작은 값이 설정 된다. 


설명 

pvm_nrecv 는 msgtag 라는 표식을 가진 통보가 tid 로부터 
도착했는가를 검 사한다. 일 치하는 통보가 도착하면 pvm _ nrecv 는 
통보를 직 접 능동인 수신완중기 에 배 치 하며 현재 의 수신완중기 를 지 운다. 
그리 고 bufid 에 통보완충기를 돌린다. 

만일 요구하는 통보가 도착하지 않으면 pvm _ nrecv 는 bufid 에 0을 
돌린다. 오유가 생기면 bufid < 0로 된다. 

msgtag 나 tid 에 -1 을 설 정 하면 임 의 의 것 을 준다. 이 것 은 리 용자가 
다음의 추가선택 을 리용하게 한다. 

만일 tid = -1이 고 msgtag 를 리용자가 정 의하였 다면 pvm _ nrecv 는 
msgtag 와 일 치하는 임의의 프로쎄스로부터 통보를 받는다. 


35 


만일 msgtag = -1 이 고 tid 를 리용자가 정 의하였 다면 pvm _ nrecv 는 
프로쎄스 tid 가 보내는 임의의 통보를 접수한다. 

만일 吐 d = -1 이고 msgtag = -1 이면 pvm_nrecv 는 임의의 

프로쎄스로부터 오는 임의의 통보를 접수한다. 

pvm _ nrecv 는 통보가 국부 pvmd 에 아직 도착하지 않았다는 통보 
혹은 정 보를 가지 고 즉시 귀 환된다는 의 미 에서 비봉쇄적 이 다. 
pvm _ nrecv 는 여 러번 호출하여 지적한 통보가 도착했는가를 검사할수 
있 다. 

추가적으로 pvm _ recv 는 만일 응용프로그람이 자료를 접수하기전에 
자기작업 을 끝낸 다면 같은 통보에 대 하여 또 호출할수 있 다. 
pvm _ nrecv 로 통보를 접 수하면 통보에 있 는 자료는 풀기 함수를 
리용하여 리용자의 기 억 구역 에 풀린 다. 

병 렬 가상기계모델 은 통보의 순서 를 담보한다. 만일 과제 1이 통보 
A 를 파제 2에 보내 고 그 다음 파제 1 이 동보 B 를 과제 2에 보내면 동보 
A 는 통보 묘보다 과제 2에 먼저 도착한다. 더우기 두 통보들이 과제 2가 
접 수하기전에 도착해 도 항상 통보 A 를 먼저 접 수한다. 

실례프로그람 

C ： 

tid = pvm _ parent () : 

msgtag = 4 ; 

arrived = pvm _ nrecv ( tid , msgtag ); 

if ( arrived > 0 ) 

info = pvm _ upkint ( tid _ array , 10, 1 ); 

else 

/* go do other computing */ 

포트란: 

CALL PVMFNRECV ( -1, 4, ARRIVED ) 

IF ( ARRIVED . GT . 0 ) THEN 
CALL PVMFUNPACK ( INTEGERS TIDS , 25, 1, 

INFO ) 

CALL PVMFUNPACK ( REAL 8, MATRIX , 100, 

100 ， INFO ) 
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ELSE 

* GO DO USEFUL WORK 
ENDIF 


오유: 

이름 

PvmBadParam 

PvmSysErr 


가능한 경우 

무효한 tid 값 혹은 msgtag 
pvmd 가 응답하지 않는다. 


pvmfpackO 


pvm _ pk *() 


지정된 자료형배렬로 능동통보완충기를 압축한다. 

문법 

C ： 

int info = pvm _ packf ( const char * fmt ，... ) 

int info = pvm _ pkbyte ( char * xp , int nitem , int stride ) 

int info = pvm _ pkcplx ( float * cp , int nitem , int stride ) 

int info = pvm _ pkdcplx ( double * zp , int nitem , 

int stride ) 

int info = pvm_pkdouble (double * dp , int nitem , 

int stride ) 

int info = pvm _ pkfloat ( float * fp , int nitem , int stride ) 

int info = pvm _ pkint ( int * ip , int nitem , int stride ) 

int info = pvm _ pkuint ( unsigned int * ip , int nitem , 

int stride ) 

int info = pvm _ pkushort ( unsigned short * ip , 

int nitem , int stride ) 

int info = pvm _ pkulong ( unsigned long * ip , int nitem , 

int stride ) 

int info = pvm _ pklong ( long * ip , int nitem , int stride ) 
int info = pvm_pkshort ( short * jp , int nitem , int stride ) 
int info = pvm _ pkstr ( char *sp ) 


37 




포트란 : 


call pvmfpack( what, xp, nitem, stride, info ) 


변수 

fmt - 압축방법 을 지 적하는 인쇄 가능한 형 식 
nitem - 압축할 항목들의 전체 개 수 

stride - 항목들을 압축할 때 리용하는 걸음， 실례로 
pvm_pkcplx 에서 stride=2 이면 모든 복소수들이 압축 
된 다. 

xp - 바이트블로크들의 시작에로의 지적자, 임의의 자료형이 될수 
있지만 대응하는 풀기자료형과 일치해 야 한다. 
cp - 적 어 도 nitem*stride 의 길 이 를 가지 는 배 렬 

zp - 적 어 도 nitem*stride 의 길 이 를 가지 는 배 정 확도배 렬 

dp - 적 어 도 nitem*stride 의 길 이 를 가지 는 배 정 확도실 수배 렬 

fp - 적 어 도 nitem*stride 의 길 이 를 가지 는 실 수배 렬 

ip - 적 어 도 nitem*stride 의 길 이 를 가지 는 옹근수배 렬 
jp - 적 어 도 nitem*stride 의 길 이 를 가지 는 integer*2 배 렬 
sp - null 로 끝나는 문자렬에로의 지적자 
what - 압축할 자료의 형 을 지 적하는 옹근수 


what 

STRING 0 
BYTE 1 1 
INTEGER 2 2 
INTEGER 4 3 


추가선택 

REAL 4 4 

COMPLEX 8 5 
REAL 8 6 

COMPLEX 16 7 


info - 귀환 코드， 오유가 생기면 0 보다 작은 값이 설정된다. 


설명 

매개 pvm_pk* 함수들은 주어진 자료형의 배렬들을 능동송신완충기에 
압축한다. 매 함수들에서 변수는 압축할 첫 항목들에로의 지적자이며 
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nitem 은 이 배렬에서 압축할 항목들의 전체 개수， stride 는 압축할 때 
리용되 는 걸 음이 다. 

한가지 례 외는 pvm _ pkstr () 이며 여 기서 는 정의 에 의 하여 null 로 
끝나는 문자렬을 압축하므로 nitem 이나 stride 같은 변수가 필요없다. 

포트란함수 pvmfpack ( STRING , ...) 에서는 nitem 이 문자렬에 
있는 문자들의 개 수라고 가정 하며 stride = l 로 가정한다. 

압축이 성 공하면 info = 0， 오유가 발생 하면 info < 0로 된다. 

단일 변수인 경 우에 는 nitem = l , stride = l 로 설정하여 압축할수 있 다. 
구조체들은 한번에 한개의 자료형을 압죽해야 한다. 

pvm _ packf () 는 인쇄 가능한 형 식의 표기를 리용하여 자료를 
무엇으로 또 어떻게 압축하여 송신완충기 에 보관하는가를 지적한다. 

모든 변수는 stride 와 count 가 지 적 되 면 주소로서 넘 어 가며 그외 
다른 경 우에 변수는 값으로 넘어 간다. 

BNF 와 류사한 형 식 적 서 술법 이 리 용된 다. 

format : null | init | format fmt 

init : null | ’%’ ’ + ’ 

fmt :，%’ count stride modifiers fchar 

fchar : ’ c ’ | ’ d ’ | T | ’ x ’ | ’ s ’ 

count : null | [0-9] + | 

stride : null | ( [0-9]+ | ’*’ ) 

modifiers : null | modifiers mchar 

mchar : ’ h ’ | T [ ’ u ’ 

형식: 

+ 는 initsend 를 의미 하며 param 목록에 있는 int 와 일치해 야 한다. 
c 압축/풀기할 바이 트를 지 적한다. 
d 옹근수 
f 류점수 
x 배 정 확도류점 수 
s 문자렬 

략자: 

h short ( int ) 
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1 long ( int , float , complex float ) 
u unsigned ( int ) 

count 나 stride 는 param 목록에 있는 int 와 일치해야 한다. 


실례프로그람 
C ： 

info = pvm _ initsend ( PvmDataDefault ); 

info = pvm _ pkstr ( "initial data " ); 

info = pvm _ pkint ( Ssize , 1, 1 ); 

info = pvm _ pkint ( array , size , 1 ); 

info = pvm_pkdouble ( matrix , size * size , 1 ); 

msgtag = 3 ; 

info = pvm _ send ( tid , msgtag ); 

포트란: 


CALL PVMFINITSEND ( PVMRAW , INFO ) 
CALL PVMFPACK ( INTEGERS NSIZE , 1, 1, 

INFO ) 


CALL PVMFPACK ( STRING , ’row 5 of NXN 

matrix ', 19，1 ， INFO ) 
CALL PVMFPACK ( REAL 8， A (5， l )， NSIZE , 

NSIZE ， INFO ) 

CALL PVMFSEND ( TID ， MSGTAG , INFO ) 


오유: 

이름 

PvmNoMem 


PvmNoBuf 


가능한 경우 

malloc 가 실패，통보완충기크기 가 이 
처리기에서 리용할수 있는 기억기를 
초과한다. 

압축에 필요한 능동인 송신완충기가 없다. 


pvmfparentO 


pvm _ parent () 


호줄한 프로쎄 스의 어 미 프로쎄 스에 대 한 tid 를 돌려 준다. 
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문법 

c ： 

int tid = pvm _ parent ( void ) 

포트란 : 

call pvmfparent ( 吐 d ) 

변수 

tid - 어 미프로쎄 스의 과제식 별 자， 만일 어 미 과제 가 없 으면 tid = 
PvmNoParent 

설명 

pvm _ parent 는 호출한 프로쎄스를 생성한 프로쎄스의 tid 를 돌려 
준다. 만일 어미과제가 없으면 tid = PvmNoParent 이 다. 

실례프로그람 
C ： 

tid = pvm _ parent () : 

포트란 : 

CALL PVMFPARENT ( TID ) 

오유: 

이름 가능한 경우 

PvmNoParent 호출한 프로쎄스는 pvm _ spawn 으로 생 

성된 프로쎄스가 아니 다. 

pvmfperrorO pvm _ perror () 


마지 막으로 호출한 병 렬 가상기 계호출의 오유상태 를 돌린 다. 

문법 

C ： 

int info = pvm _ perror ( char *msg ) 

포트란 : 

call pvmfperror ( msg , info ) 

변수 
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msg - 마지 막 병 렬 가상기계호출의 오유통보에 첨 부되 는 리용자가 
제공하는 문자렬 

info - 귀환 코드， 오유가 생긴 경우 0 보다 작은 값이 설정된다. 

설명 

pvm_perror 는 마지 막 병 렬 가상기 계 호출에 대 한 오유통보를 
돌려 준다. 리 용자는 msg 를 리 용하여 오유통보에 보중적 인 정 보들， 
실례로 그의 위치 등을 첨부할수 있다. 

모든 표준출구 및 표준오유통보들은 주 pvmd 가 실행하는 처 리 기의 
/tmp/pvml. <uid> 파일 에 보관된다. 

실례프로그람 
C ： 

if ( pvm_send( tid, msgtag )) 
pvm_perror(); 

포트란 : 

CALL PVMFSEND( TID, MSGTAG ) 

IF( INFO .LT. 0 ) 

CALL PVMFPERROR( ’Step 6’， INFO ) 

오유: 

오유없음 


pvmfprecvO 


pvm_precv() 


완충기안에 로 통보를 직 접 수신한다. 

문법 

C ： 

int info = pvm_psend( int 吐 d, int msgtag, 

char *buf, int len, int datatype, int 
atid, int atag, int alen ) 

포트란 : 

call pvmfpsend( tid, msgtag, buf, len, datatype, 

atid, atag, alen, info ) 
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변수 

tid - 송신프로쎄스의 과제식별자 

msgtag - 통보표적， msgtag >= 0이 여 야 한다. 

buf - 통보를 수신할 완충기에 로의 지적 자 

len - 완충기 의 길 이 

datatype - buf 가 지 적 하는 자료의 형 

atid - 송신자의 실제 TID 

atag - 실제적 인 통보표적 

atid - 통보의 실제길이 

info - 상태코드，오유가 생기면 0보다 작은 값이 설정된다. 

설명 

pvm_recv 는 msgtag 라는 표식을 가진 통보가 吐(그로부터 도착할 
때 까지 프로쎄 스를 봉쇄 한다. pvm_precv 는 다음 준비 된 통보완충기 
buf 에 통보를 넣는다. 

pvm_precv 는 pvm _ psend , pvm _ send , pvm _ mcast , 혹은 
pvm_bcast 가 보낸 통보를 접수할수 있다. msgtag = _1이든가 tid = - 
1 이면 임의의 통보를 접수한다. 

이때 리용자는 아래의 추가선택들중 임의의 추가선택을 리용할수 
있 다. 

tid = -1 이 고 msgtag 를 리용자가 정 의하였 다면 pvm_recv 는 임 의 
의 프로쎄스로부터 msgtag 를 가진 통보를 접수할수 있다. 

msgtag = ᅳ1이 고 tid 를 리용자가 정 의하였 다면 pvm_recv 는 프로 
쎄스 tid 가 보내는 임의의 통보를 접수한다. 

tid = -1 이고 msgtag = -1 이면 pvm_recv 는 임의의 프로쎄스로부터 
임의의 통보를 접수한다. 

C 에서 datatype 변수는 전송하는 자료의 형에 따라 다음의 변수중 
하나로 된다. 


datatype 자료형 

PVM_STR string 

PVM_BYTE byte 

PVM SHORT short 
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PVMJNT 

PVM_FLOAT 

PVM_CPLX 

PVM_DOUBLE 

PVM_DCPLX 

PVM_LONG 

PVM_USHORT 

PVMJJINT 

PVM ULONG 


int 

real 

complex 

double 

double complex 
long integer 
unsigned short int 
unsigned int 
unsigned long int 


포트란에 서 는 풀기 에 서 와 같은 자료형 들이 리 용된 다. 병 렬 가상기계 
모형은 동보의 순서를 담보한다. 만일 과제 1 이 동보 A 를 파제 2에 
보내고 다음 과제 1이 통보 묘를 과제 2 에 보내면 통보 A 는 통보 
B 보다 과제 2에 먼저 도착한다. 

더 우기 두 통보들이 과제 2가 접 수하기전 에 도착해 도 항상 통보 A 를 
먼저 접수한다. pvm_recv 는 봉쇄된다. 이것은 리용자가 지적한 tid 와 
msgtag 를 가진 통보가 국부 pvmd 에 도착할 때까지 이 함수가 
대 기 하고있는다는것 을 의 미한다. 만일 통보가 이 미 도착하였 다면 
pvm_recv 는 통보와 함께 즉시 귀환한다. pvm_precv 는 현재 
수신통보완충기의 상태 에 영향을 주지 않는다. 

실례프로그람 

C ： 

info = pvm _ precv ( 吐 d , msgtag , array , cnt , 

PVM _ FLOAT , & src , Satag , Sacnt ) : 

포트란: 

CALL PVMFPRECV ( -1, 4, BUF , CNT , REAL 4, 

SRC , AT AG , ACNT , INFO ) 


오유: 

이름 

PvmBadParam 

PvmSysErr 


가능한 경우 

무효한 tid 혹은 msgtag 
pvmd 가 응답하지 않는다. 
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pvmfprobeO 


pvm _ probe () 


통보가 도착했는가를 검사한다. 

문법 

C ： 

int bufid = pvm _ probe ( int tid , int msgtag ) 

포트란: 

call pvmfprobe ( tid , msgtag , bufid ) 

변수 

tid - 리 용자가 주는 송신프로쎄 스의 프로쎄 스 id 
msgtag - 리 용자가 주는 통보의 표적， msgtag >= 0 이여야 한다. 
bufid - 새로운 능동수신완충기식별자의 값，오유가 생기면 0보다 
작은 값이 설정된다. 


설명 

pvm_probe 는 msgtag 라는 표식 이 붙은 통보가 tid 로부터 
도착했는가를 검 사한다. 일 치하는 통보가 도착하면 pvm_probe 는 
bufid 에 완충기 식 별 자를 넘 겨 준다. 이 bufid 는 pvm_bufinfo 호출에 서 
리용하여 그의 원천지와 길이가 같은 통보에 대한 정보를 결정하는데 
리용된 다. 

만일 요구하는 통보가 도착하지 않으면 pvm_probe 는 bufid =0 을 
돌린다. 오유가 발생 하면 bufid < 0으로 된다. msgtag = -1 이든가 tid 
= -1 이면 임의의 통보를 접수한다. 

이때 리용자는 아래의 추가선택들중 임의의 추가선택을 리용할수 
있 다. tid = ᅳ1 이 고 msgtag 를 리용자가 정 의하였 다면 pvm_probe 는 
임의의 프로쎄스로부터 msgtag 를 가진 통보를 접수할수 있다. msgtag 
= -1 이 고 tid 를 리용자가 정 의하였 다면 pvm_probe 는 프로쎄 스 tid 가 
보내는 임의의 통보를 접수한다. 

tid = ᅳ1이고 msgtag = -1 이면 pvm_probe 는 임의의 프로쎄스 
로부터 임의의 통보를 접수한다. 리용자는 pvm_probe 는 여 러 번 
호줄하여 주어진 통보가 도착하였는가를 검사할수 있다. 
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통보가 도착하면 풀기함수를 리용하여 통보를 리용자의 기억구역에 
풀기 전에 pvm _ recv 를 먼저 호출하여 야 한다. 

실례프로그람 
C ： 

tid = pvm _ parent () : 
msgtag = 4 ; 

arrived = pvm _ probe ( 吐 d，msgtag ); 
if ( arrived > 0 ) 

info = pvm _ bufinfo ( arrived , & len , Stag , &tid ); 
else 

/* 다른 계산을 진행 */ 

포트란: 

CALL PVMFPROBE ( -1, 4, ARRIVED ) 

IF ( ARRIVED . GT . 0 ) THEN 

CALL PVMFBUFINFO ( ARRIVED , LEN , TAG , 

TID , INFO ) 

ELSE 

* GO DO USEFUL WORK 
ENDIF 

오유: 

이름 

PvmBadParam 
PvmSysErr 

pvmfpsendO 


가능한 경우 

무효한 tid 혹은 msgtag 
pvmd 가 웅답하지 않는다. 

pvm _ psend () 


한번의 호출로 자료를 압축하고 전송한다. 


문법 

C ： 

int info = pvm _ psend ( int tid , int msgtag , char 
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*buf, int len, int datatype ) 


포트란 : 

call pvmfpsend( tid, msgtag, buf, len, datatype, 

info ) 

변수 

tid - 목적 지 프로쎄 스의 과제 식 별 자 

msgtag - 리 용자가 지적 한 통보표적， msgtag >= 0 이다. 

buf - 송신할 완충기에로의 지적 자 

len - 완충기 의 길 이 

datatype - buf 가 지 적 하는 자료의 형 

info - 상태 코드， 오유가 생기면 0 보다 작은 값이 설정된다. 


설명 

pvm_psend 는 길이가 len 이고 그의 자료형이 datatype 인 완충기 
buf 에 로의 지 적자를 주며 이 자료를 지 적된 병 렬가상기 계과제 에 직 접 
전송한다. pvm_psend 자료는 pvm_precv, pvm_recv, pvm_trecv, 
혹은 pvm_nrecv 로 접수할수 있다. 

msgtag 는 통보의 내 용을 표시 하는데 리 용할수 있 다. pvm_send 는 
성공하면 info = 0 이며 오유가 생기면 info < 0 으로 된다. pvm_psend 
는 비 동기 적 이 다. 

송신 프로쎄 스에 서 연산은 통보가 수신 프로쎄 스에 안전하게 도착하자 
마자 계속하여 진행된다. 이 방식은 동기동신파는 대조적이다. C 에서 
datatype 변수는 다음의 값들중의 하나일수 있다. 


datatype 

PVM_STR 

PVM_BYTE 

PVM_SHORT 

PVMJNT 

PVM_FLOAT 

PVM_CPLX 

PVM_DOUBLE 

PVM DCPLX 


자료형 
string 
byte 
short 
int 
real 

complex 

double 

double complex 
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PVM LONG 


long integer 


PVM_USHORT 
PVMJJINT 
PVM ULONG 


unsigned short int 
unsigned int 
unsigned long int 


포트란에 서 는 압축을 할 때 리용한 자료형 과 같은 형 의 자료형 들이 
리 용된 다. 병 렬 가상기계 모형 은 통보의 순서 를 보존한다. 

만일 과제 1이 통보 A 를 과제 2에 보내고 그 다음 과제 1이 통보 
묘를 과제 2 에 보내면 통보 A 는 통보 묘보다 과제 2에 먼저 도착한다. 
더 우기 두 통보들이 과제 2가 접 수하기전에 도착해 도 항상 통보 A 를 
먼저 접수한다. 

pvm _ psend 는 현재 송신을 위해 준비 된 다른 통보완충기 의 상태 에 는 
영향을 주지 않는다. 

실례프로그람 
C ： 

info = pvm _ psend ( tid , msgtag , array , 1000, 

PVM_FLOAT ); 

포트란: 

CALL PVMFPSEND ( TID , MSGTAG , 

BUF , CNT , REAL 4, INFO ) 


가능한 경우 

무효한 tid 혹은 msgtag 
pvmd 가 응답하지 않는다. 

pvm _ pstat () 


오유: 

이름 

PvmBadParam 

PvmSysErr 

pvmfpstatO 


지 적된 프로쎄스의 상태를 돌려 준다. 


문법 

C ： 
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int status = pvm _ pstat ( tid ) 

포트란 : 

call pvmfpstat ( tid , status ) 

변수 

tid - PVM 프로쎄 스의 과제 식 별 자 
status - tid 로 지 적된 병 렬가상기 계프로쎄스의 상태 
과제 가 실 행 하고있으면 상태 는 PvmOk 이 며 그러한 과제 가 없으면 
PvmNoTask , 社선가 틀리면 PvmBadParam 로 된다. 


설명 

pvm _ pstat 는 tid 로 지 적된 프로쎄스의 상태를 돌려준다. 


실례프로그람 


C ： 


tid = pvm _ parent () : 
status = pvm _ pstat ( tid ); 

포트란 : 


CALL PVMFPARENT ( TID ) 

CALL PVMFPSTAT ( TID , STATUS ) 


오유: 

이름 

PvmBadParam 

PvmSysErr 

PvmNoTask 


가능한 경우 
변수가 틀렸다. 
pvmd 가 응답하지 않는다. 
과제 가 실 행하지 않는다. 


pvmfrecvO 


pvm _ recv () 


통보를 수신한다. 

문법 

C ： 

int bufid = pvm _ recv ( int 吐 d , int msgtag ) 


포트란 : 
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call pvmfrecv ( tid, msgtag, bufid ) 

변수 

tid - 리용자가 제 공한 송신측 프로쎄스의 과제식 별자 

msgtag - 리 용자가 제공하는 통보의 표적 ， msgtag >= 0이다. 

리용자는 이 변수의 내 용을 보고 여 러 가지 통보들을 
구별 한다. 

bufid - 새 로운 능동수신완충기의 식 별자를 돌린다. 

오유가 생기면 0보다 작은 값을 돌린다. 

설명 

pvm_recv 는 msgtag 라는 표식을 가진 통보가 tid 로부터 도착할 
때 까지 봉쇄 한다. pvm_:recv 는 다음 통보를 새 로운 능동수신완중기 에 
배 치 하는데 이 때 현재 의 수신완충기 를 지 운다. msgtag = -1 이 든가 
tid = -1 이면 임의의 통보를 접수한다. 이때 리용자는 아래의 

추가선택들중 임의의 추가선택을 리용할수 있다. 

tid = -1 이 고 msgtag 를 리용자가 정 의하였 다면 pvm_recv 는 

임의의 프로쎄스로부터 msgtag 를 가진 통보를 접수할수 있다. 

msgtag = 一1이 고 tid 를 리 용자가 정 의하였 다면 pvm_recv 는 
프로쎄스 tid 가 보내는 임의의 통보를 접수한다. 

tid = -1이고 msgtag = -1이면 pvm_recv 는 임의의 프로쎄스로부터 
임의의 통보를 접수한다. 병 렬가상기계모델은 통보의 순서를 보존한다. 

만일 과제 1이 통보 A 를 과제 2에 보내고 그 다음 과제 1이 통보 
B 를 과제 2 에 보내면 통보 A 는 통보 묘보다 과제 2에 먼저 도착한다. 
더 우기 두 통보들이 과제 2가 접 수하기전에 도착해 도 항상 통보 A 를 
먼저 접수한다. 

pvm_recv 가 성공하면 bufid 에는 새로운 능동수신완충기의 값이 
보관되 며 실 패하면 bufid < 0으로 된 다. 

pvm_recv 는 봉쇄한다. 이것은 리용자가 지적한 tid 와 msgtag 와 
일 치하는 통보가 pvmd 로부터 도착할 때 까지 이 함수가 기 다린 다는것 을 
의 미 한다. 

통보가 이미 도착하였으면 pvm_recv 는 통보와 함께 즉시 귀환한다. 
일 단 pvm_recv 가 돌아오면 통보에 있는 자료는 풀기 함수를 리 용하여 
리용자의 기억기에 풀어진다. 
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실례프로그람 
C ： 

tid = pvm _ parent () : 
msgtag = 4 ; 

bufid = pvm _ recv ( tid , msgtag ); 
info = pvm _ upkint ( tid _ array , 10, 1 ); 
info = pvm _ upkint ( problem _ size , 1, 1 ); 
info = pvm _ upkfloat ( input _ array , 100, 1 ); 


포트란: 


CALL PVMFRECV ( -1, 4, BUFID ) 

CALL PVMFUNPACK ( INTEGERS TIDS , 25，1， 

INFO ) 

CALL PVMFUNPACK ( REAL 8， MATRIX , 100， 

100 ， INFO ) 


오유: 

이름 

PvmBadParam 

PvmSysErr 


가능한 경우 

무효한 tid 혹은 msgtag <-1 
pvmd 가 웅답하지 않는다. 


pvm_recvf 0 


통보를 접 수하기 위하여 비 교함수들을 다시 정 의한다. 

문법 

C ： 

int (* old )() = pvm _ recvf ( int (* new )( int bufid , int tid , int tag )) 
포트란: 

없 음 

변수 

tid - 리용자가 제 공한 송신프로쎄스의 과제식 별자 
tag - 리용자가 제 공한 통보표적 
bufid - 통보완충기 식 별 자 
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설명 

pvm _ recvf 는 pvm _ recv 와 pvm _ nrecv 함수들에 서 리 용하는 비 교 
함수들을 정 의한다. 

pvm _ recvf 는 리 용자가 제 공한 비 교함수를 설 정 하여 수신하는 동보 
들을 평가한다. 기정의 비교함수는 모든 오는 통보들과 관련한 원천 및 
통보표적들을 평 가한다. 

pvm _ recvf 는 그러한 함수들의 기 능을 파악하고있고 기정의 것보다 
더 복잡한 통보문맥 들을 통신하려 고 하는 C 프로그람작성 자들을 위하여 
나왔다. 

pvm _ recvf 는 기정의 일치함수라면 0 을 돌려주며 다른 경우 일치 
함수를 돌려준다. 일치 함수는 다음의 값을 돌린다. 

값 취 하는 동작 

< 0 오유코드를 가지 고 즉시 귀환한다. 

0 이 통보를 받지 않는다. 

1 이 통보를 받으며 나머지는 주사하지 않는다. 

> 1 주사후에 가장 높은 급의 통보를 받는다. 

실례프로그람 
^include " pvm . h " 
static int foundit = 0； 

static int 

foo _ match ( mid , tid , code ) 
int mid ； 
int tid ； 
int code ； 

{ 

int t , c , cc ； 

if ((cc = pvm _ bufinfo ( mid , (int *)0, & c , & t )) < 0) 
return cc ； 

if ((tid == -1 | l tid == t ) 
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&& (code == -1 || code == c)) 
foundit = 1; 
return 0 ； 

} 

int probe(src, code) 

{ 

int Oomatch) (); 
int cc ； 

omatch = pvm_recvf (foo_match) : 
foundit = 0 ； 

if ((cc = pvm_nrecv(src, code)) < 0) 
return cc ； 
pvm_recvf (omatch); 
return foundit ； 

} 

오유 : 

오유없음 

pvmfreduceO pvm_reduce() 

지적한 그룹의 성 원들에서 축소연산을 수행한다 . 

문법 

C ： 

int info = pvm_reduce( void (*func) 0, 

void *data, int count, int datatype, 
int msgtag, char *group, int root) 

포트란 : 

call pvmfreduce( func, data, count, datatype, 

msgtag, group, root, info ) 


변수 
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func — 대 역 자료우에 서 진행 하는 연산들을 정 의 하는 함수 

미리 정의된 함수들은 PvmMax , PvmMin , PvmSum , 
그리 고 PvmProduct 이 다. 리 용자들은 자기 자체 의 
함수들을 정 의할수도 있 다. 

data - 국부값 배렬의 시작주소에로의 지적자，귀환할 때 뿌리에 
있는 자료배렬은 그룹에서의 축소연산결과와 함께 중복하여 
쓴다. 

count - 자료배 렬 에 있 는 요소들의 개 수를 지 적하는 옹근수 

datatype - 자료배 렬 에 있 는 마디 들의 형 을 지 적하는 옹근수 

msgtag - 리 용자가 제 공하는 통보표적， msgtag >= 0이 여 야 한다. 

group - 현존 그룹의 그룹이름 

root — 결파를 얻 는 그롭성 원의 실체 개수 

info - 상태코드，오유가 생기면 0보다 작은 값이 설정된다. 

설명 

pvm _ reduce () 는 그룹에 있는 모든 과제들에서 최대값, 최소값얻기， 
더 하기 와 같은 연산을 수행한다. 

모든 그룹성원들은 자기의 국부자료와 함께 pvm _ reduce () 를 
호출하며 축소연산의 결과는 리용자가 지적한 뿌리과제 root 에 나타난다. 
뿌리과제는 그롭에 있는 그의 실체번호로 나타난다. 

병 렬 가상기 계 는 다음과 같은 미 리 정 의 한 대 역 함수들을 func 에 
지 적할수 있 다. 

PvmMin 

PvmMax 

PvmSum 

PvmProduct 

PvmMax 와 PvmMin 는 자료형 이 byte , short , integer , long , 
float , double , complex , double complex 인 자료들에 대 하여 
수행 한다. 

PvmSum 과 PvmProduct 는 자료형 이 short , integer , long , 
float , double , complex , 그리고 double complex 인 자료들에 
대 하여 수행한다. C 와 포트란에는 다음의 자료형 들이 미 리 정의되 여있다. 
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C 자료형 

PVM_BYTE 

PVM_SHORT 

PVMJNT 

PVM_FLOAT 

PVM_CPLX 

PVM_DOUBLE 

PVM_DCPLX 

PVM LONG 


포트란 자료형 
BYTE 1 
INT 2 
INT 4 
REAL 4 
COMPLEX 8 
REAL 8 
COMPLEX 16 


리용자가 정의한 함수도 func 에서 리용할수 있는데 그 형식은 아래와 
갈다. 

C ： 

void func(int ^ datatype , void * x , void * y , int * num , int 
* info ) 

포트란: 

call func ( datatype , x , y , num , info ) 
func 는 축소연산에 서 리용하는 기 본기 능이 다. x 와 y 는 num 개 의 
입 구점 들을 가지 고있는 datatype 형 의 자료배 렬이 다. 변수 datatype 와 
info 는 우에 서 지 적한것 과 같다. 변수 표와 num 은 우의 data 와 
count 값과 대응된다. 변수 모는 수신한 값들을 가지고있다. 


주의: 

pvm _ reduce () 는 봉쇄 하지 않는다. 만일 과제 가 pvm _ reduce 를 
호출하고 뿌리과제 가 pvm _ reduce 를 호출하기 전에 그룹을 리 랄한다면 
유가 생 긴다. 현재 알고리 듬은 아주 단순하면서 도 믿 음직하다. 


실례프로그람 
C ： 

info = pvm _ reduce ( PvmMax , Smyvals , 10, PVMJNT , 

msgtag , " workers ", roottid ) : 
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포트란: 


CALL PVMFREDUCE ( PvmMax , MYVALS , COUNT , 

INT 4, MTAG ， ’ workers ’， 
ROOT , NFO ) 

오유: 

이름 

PvmBadParam 
PvmNoInst 
PvmSysErr 


가능한 경우 
무효한 변수 

호출한 과제 가 그룹에 없다. 
국부 pvmd 가 응답하지 않는다. 


p vm _ reg_hoster () 


새로운 병 렬가상기계처 리기들을 첨 가하기 위하여 이 과제를 등록한다. 

문법 

C ： 

^include < pvmsdpro . h > 
int info = pvm _ reg_hoster () 

변수 

info - 귀 환상태코드 

설명 

pvm _ reg_hoster 는 호출한 과제를 병렬가상기계의 종속 
pvmd 시동자로 등록한다. 주 pvmd 는 DM _ ADD 통보를 접수하면 새로운 
종속 pvmd 프로쎄 스를 생 성 하는것 이 아니 라 이 통보를 hoster 에 게 
넘긴 다. 

주 pvmd 가 DM _ ADD 통보를 받으면(가상기 계 에 처 리 기를 
첨부하라는 요구)새로운 처리기의 IP 주소를 얻고 만일 그것이 생성 
되 였으면 처 리기로부터 변수를 얻 고 그것을 기정의 변수로 설정한다. 
다음에 프로쎄 스를 생 성하든가 hoster 가 등록되 여있 으면 그에 게 
SM _ STHOST 통보를 보낸다. SM STHOST 통보의 형식은 다음과 같다. 


// 호스트들의 수 


int nhosts 
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int tid 

string options 
string login 
string command 


// 호스트의 tid 

// 호스트파일 so = 마당으로부터 
//형식 ‘‘[ username @] hostname . domain ” 
// 원격 호스트에서 실행하기 위 하여 


에서 


$ PVM _ ROOT / lib/pvmd -s - d 8 -nhonk 1 80 a 9 ca 95：0 f 5 a 4096 
3 80 a 95 c 43：0000 

그리고 종속 pvmd 는 다음과 같이 응답한다. 


ddpro <2312> arch < ALPHA > ip <80 a 95 c 43 : 0 b 3 f > mtu <4096> 


완료하면 hoster 는 SM_STHOSTACK 통보를 송신자의 주소(주 
pvmd ) 에 돌려보낸다. 

응답통보의 형식은 다음과 같다. 

int tid ; 

string status : 

응답하는 TID 들은 요구한것들과 일치해야 한다. 그러나 순서는 차이 
날수 있다. 

hoster 는 기 정 으로 PvmDSysErr 혹은 PvmCantStart 를 돌려주며 
종속 pvmd 그 자체는 PvmDupHost 를 돌려준다. 

hoster 과제 는 pvm _ setopt ( PvmResvTids , 1) 를 리 용하여 예 약된 
통보들을 보낼 수 있 다. 통보들은 자료형 식 PvmDataFoo 를 리용하여 
압축해 야 한다. 


pvm _ reg_rm () 


병 렬 가상기계 의 자원관리자로 이 과제 를 등록한다. 


문법 
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c ： 

^include < pvmsdpro . h > 

int info = pvm _ reg_rm ( struct hostinfo **hip ) 
struct hostinfo 
{ 

int hi 一 tid ; 
char * hi _ name ； 
char * hi _ arch : 
int hi _ speed : 

} hip ； 

변수 

hostp - pvmd 의 과제 id , 이름，구성방식，관련속도와 같은 매 
처 리 기 관련정 보들을 가지 고있는 구조체 배 렬 에 로의 지 적 자 
info - 상태 코드， 오유가 생기면 0보다 작은 값이 설정된다. 

설명 

pvm _ reg_rm () 은 호출한 과제를 병렬가상기 계과제로 등록하며 종속 
처 리기일정작성기로 등록한다. 이것은 계획화전략에 대응하기 위하여 
특정 의 libpvm 이 다른 과제 들과 간섭 한다는것 을 의 미한다. 

계획화기구는 체계의 실패와 같은 통지들을 pvmd 들에 보내는 
봉사요구들을 가지 고있는 통보들을 과제들로부터 접 수한다. 

주의: 

이것은 작은 과제가 아니다. 이것은 단순한 순환식과제 

분배방법 으로는 호출할수 없 으며 특수한 일 정작성규칙 에 따라야 한다. 

이러한 통보들의 의미를 리해하자면 병렬가상기계의 원천코드를 
해 석 하거 나 지 도서 를 참고하여 야 한다. 


Libpvm 호출 _ 계 획 화통보 _ 임 반 통보 

pvm _ addhosts () SM_ADDHOST TM_ADDHOST 

pvm _ config () SM_CONFIG TM_CONFIG 

pvm _ delhosts () SM_DELHOST TM_DELHOST 
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pvm_notify 0 
pvm _ spawn () 
pvm_tasks 0 


SM_NOTIFY 
SM_SPAWN 
SM TASK 


TM—NOTIFY 
TM—SPAWN 
TM_TASK 
TM SCHED 


p vm _ reg_sched 0 SM_SCHED 


자원관리 자들은 차례 로 다음의 통보들을 구성 하여 pvmd 들에 전송 
하여 야 한다. 


계 획 화통보 표준통보 


SM_EXEC 

SM_EXECACK 

SM—ADD 

SM_ADDACK 

SM_HANDOFF 


DM_EXEC 

DM_EXECACK 

DM_ADD 

DM_ADDACK 

( none ) 


아래의 통보들은 체계가 비동기적으로 자원관리자에 보내준다. 
계 획 화통보 의 미 


SM_TASKX 과제 의 완료/실 패 를 통지한다. 
SM.HOSTX 처 리기 가 삭제/실패하였음을 통지한다. 


자원관리 자는 pvm _ setopt ( PvmResvTids , 1) 를 리 용하여 예 약된 
통보를 보내게 하여 야 한다. 

통보들은 자료형 식 PvmDataFoo 를 리용하여 압축한다. 


pvm _ reg 一 tasker () 


새 로운 병 렬 가상기 계 과제 들을 생 성하기 위하여 이 과제 를 등록한다. 


문법 
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c ： 


^include < pvmsdpro . h > 
int info = pvm _ reg_tasker () 


변수 

info - 상태 코드 
설명 

pvm _ reg_tasker 는 호출한 과제를 병렬가상기계의 과제시동자로 
등록한다. tasker 가 pvmd 와 함께 등록되 고 pvmd 가 DM _ EXEC 통보를 
접 수하면 fork () 나 exec 0 로 과제 를 실 행하지 않고 tasker 에 이 통보를 
넘겨준다. 

pvmd 는 DM _ EXEC 통보를 접 수하면 (새 로운 과제 들을 실 행 하라는 
요구)파일 이 름을 가지 고 그 파일 이 들어있는 등록부를 조사한다. 그 
파일 을 찾으면 fork () 와 exec 0를 리 용하여 과제 를 실 행하며 tasker 가 
등록되 여있는 경 우에 는 SM _ STTASK 를 그에 게 보낸다. 

SM _ STTASK 통보의 형식은 다음과 같다. 

int tid ； 
int flags ； 
string path ； 
int argc ； 

string argv [ argc ]; 
int nenv ； 
string env [ nenv ] : 

tasker 는 이 통보를 받으면 프로쎄 스를 실 행한다. 만일 과제 가 
성공적으로 실행한다면 tasker 는 pvmd 에 응답하지 않는다. 과제는 
자체로 pvmd 에 다시 련결된다. 만일 어떤 과제가 완료하면 tasker 는 
SM _ TASKX 통보를 pvmd 에 보내야 한다. SM _ TASKX 통보의 형식 
은 다음과 갈다. 

int tid ； 
int status ； 
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int u _ sec : 
int u _ usec ； 
int s sec ； 


int s usee ； 


tasker 는 pvm _ setopt ( PvmResvTids , 1) 를 리 용하여 예 약된 통보 
들을 보내 야 한다. 통보들은 PvmDataFoo 형식으로 압축하여 야 한다. 

pvmfsendO pvm _ send () 


능동통보완중기 에 자료를 보낸다. 

문법 

C ： 

int info = pvm _ send ( int tid , int msgtag ) 

포트란: 

call pvmfsend ( tid , msgtag , info ) 

변수 

tid - 목적 프로쎄 스의 과제 식 별 자 

msgtag - 리 용자가 지 적 한 통보표적 ， msgtag >= 0 

info - 상태 코드， 오유가 생기면 0보다 작은 값이 설정된다. 

설명 

pvm _ send 는 능동송신완충기 에 기 억된 통보를 tid 로 지적한 병 렬 
가상기 계프로쎄 스에 보낸 다. msgtag 는 통보의 내 용을 표시 하기 위하여 
리용한다. pvm_send 는 성공하면 info = 0 오유가 생기면 info < 
0으로 된다. 

pvm _ send 는 비 동기적 이 다. pvm _ send 는 먼저 목적 지 가 같은 
프로쎄스가 아닌가를 검사한다. 

목적 지 가 같은 처 리 기 이 고 이 처 리 기 가 다중처 리 기 이 면 제 작자가 
지 원하는 통보전 달기 능들을 리 용하여 프로쎄 스들사이 에 자료를 이 동한다. 
실례프로그람 
C ： 
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info = pvm_initsend( PvmDataDefault ); 
info = pvm_pkint( array, 10, 1 ); 
msgtag = 3 ; 

info = pvm_send( tid, msgtag ); 

포트란: 

CALL PVMFINITSEND (PVMRAW, INFO) 

CALL PVMFPACK( REAL8, DATA, 100, 1, INFO ) 
CALL PVMFSEND( TID, 3, INFO ) 


오유 : 

이름 

PvmBadParam 

PvmSysErr 

PvmNoBuf 


가능한 경우 

무효한 tid 혹은 msgtag < 0 
pvmd 가 응답하지 않는다 . 

능동인 송신완충기가 없다 . 

송신하기전에 pvm_initsend () 를 호출하시 오 . 


pvmfsendsigO 


pvm_sendsig() 


다른 병 렬 가상기 계 프로쎄 스에 신호기 를 보낸 다 . 


문법 

C ： 

int info = pvm_sendsig( int 吐 d, int signum ) 

포트란: 

call pvmfsendsig( 吐 d, signum, info ) 

변수 

tid - 신호기를 접수할 병 렬가상기계프로쎄스의 과제식 별자 
signum - 신호기번 호 

info - 상태 코드， 오유가 생기면 0 보다 작은 값이 설정된다 . 


설명 
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pvm_sendsig 는 신호기번호 signum 을 tid 로 지적한 병렬가상 
기 계프로쎄 스에 보낸 다 . pvm_sendsig 가 성 공하면 info = 0 오유가 
생기면 info < 0 으로 된다 . 

pvm_sendsig 는 신호기 조종경 험 을 가지 고있는 리용자가 리용하여 야 
한다 . 이 함수는 병렬처 리환경에서 예측할수 없는 거동，교착상태，체계 
실패 와 같은 사건들을 처 리하는데 리용할수 있다 . 

실례프로그람 
C ： 

tid = pvm_parent() : 

info = pvm_sendsig( tid, SIGKILL) : 

포트란: 

CALL PVMFBUFINFO( BUFID ， BYTES, TYPE, TID, INFO ) 
CALL PVMFSENDSIG( TID, SIGNUM, INFO ) 

오유 : 

이름 

PvmSysErr 
PvmBadParam 

pvmfsetoptO 


가능한 경우 

pvmd 가 응답하지 않는다 . 

무효한 tid 값 

pvm_setopt() 


여 러 가지 병 렬가상기계서고 추가선택 들을 설정한다 . 


문법 

C ： 

int oldval = pvm_setopt( int what, int val ) 

포트란: 

call pvmfsetrbuf( what, val, oldval ) 

변수 

what — 무엇 을 설정 하는가를 지 정 하는 옹근수，주가선택 들은 다음과 
같다 . 
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추가선택 


값 


의미 


PvmRoute 

1 

경로규칙 

PvmDebugMask 

2 

오유수정 마스크 

PvmAutoErr 

3 

자동오유보고 

PvmOutputTid 

4 

자식과제의 표준출구 

PvmOutputCode 

5 

출구통보표적 

PvmTraceTid 

6 

자식과제들의 추적수단 

PvmTraceCode 

7 

추적통보표적 

PvmFragSize 

8 

통보의 토막크기 

PvmResvTids 

9 

통보들이 예약된 표적들과 



TID 들에 허용 

val - 주가선매값을 

지 정 하는 

옹근수，미리 정의된 값들은 

같다 . 



추가선택 


값 의 미 

PvmDontRoute 

1 

련결요구하지 않거나 허가하지 



않음 

PvmAllowDirect 

2 

련결요구하지 않고 허 가함 

PvmRouteDirect 

3 

련결요구하고 허 가함 


oldval - 이전에 설정된 주가선택을 돌려주는 옹근수 
설명 

pvm_setopt 는 리용자가 이 함수를 리용하여 병렬가상기계체계에 
추가선택 들을 설정할수 있게 하는 일 반목적함수이다 . 

PVM 3. 2 에 서 pvm_setopt 는 자동오유인쇄，오유수정 준위 , 통신 
경 로지 정 방법 들을 포함하여 여 러 가지 추가선택 들을 설 정하는데 리용할수 
있다 . pvm_setopt 는 oldval 에 이미 설정하였던 추가선택을 돌려준다 . 

pvmRoute ： 통신경로지정인 경우에 pvm_setopt 는 직접 과제 - 

과제 를 련 결 하는 PvmRouteDirect 를 설 정 할것 을 병 렬 가상기 계 에 
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권고한다. 일단 련결이 수립되면 응용프로그람이 완료할 때까지 
유지 한다. 

만일 두 과제들중 하나가 PvmDontRoute 련결을 요구하기 때문에 
혹은 요구하는 자원 이 없 어 직 접 련결 할수 없 다면 병 렬 가상기계 데 몬을 
통한 기정의 경 로지정 을 리용한다. 

인텔 파라곤과 같은 다중처 리 기 체 계 에 서 는 이 추가선택 을 무시 한다. 
그것은 이 기계들에서는 과제들사이의 통신이 처리기전용의 직접통신 
방법 을 리용하기 때 문이 다. 

pvm _ setopt 는 여 러 번 호출하여 교대 적 으로 직 접련결을 실현할수 

있 다. 

pvmAllowDirect 는 기 정 으로 설 정 한 경 로지 정 추가선택 이 다. 

두 과제 들사이 에 일 단 직 접련결 을 하면 과제 들은 통보를 전송하는데 
이것을 리용할수 있다. 

PvmDebugMask : 이 추가선택에 대하여 val 은 오유수정 준위로 
된다. 오유수정이 설정되면 병렬가상기계는 동작 
파정전반에 대 한 정보를 구체적 으로 기록한다. 

PvmAutoErr ： 자동오유보고인 경우 오유를 내보내는 임의의 
병 렬 가상 기 계함수들은 자동적 으로 오유통보를 인쇄한다. 

PvmOutputTid ： 이 추가선택에 대하여 val 은 자식과제의 표준 
출구장치 로 된다. 호출한 과제 와 그가 실행시 킨 임의의 다른 과제 들의 
표준출구는 지적한 장치로 출구한다. val 은 병렬가상기계의 과제 혹은 
pvmd 의 tid 이 다. 0으로 기정설정하면 주처 리 기의 표준출구로 되며 
/ tmp / pvml . < uid > 에 기 록된다. 

PvmOutputCode : 이 것은 PvmOutputTid 를 자기 자체 에 설정 한 
경우에 의미가 있다. 이것은 다른 과제들로부터의 표준출구를 
포함하고있는 수신통보들에서 리용하는 통보표적 이 다. 

PvmTraceTid ： 이 추가선택에 대하여 val 은 호출한 프로쎄스와 
그의 자식 과제 들에 대 한 주적 사건들을 기 록하는 파제 를 지 적 한다. val 은 
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병 렬 가상기계 과제 혹은 pvmd 의 과제 id 이 다. val 을 0으로 기 정 설정하면 
주처리기에로 추적사건을 돌린다. 

PvmTraceCode : 이 것 은 PvmTraceTid 를 자기 자체 에 설 정 한 
경우에 의미가 있다. 이것은 다른 과제들로부터의 추적표준출구를 포함 
하고있는 수신통보들에 서 리용하는 통보표적 이 다. 

PvmFragSize ： 이 추가선택에 대하여 val 은 바이트로 된 통보의 
토막크기 를 지 적 한다. 

실례프로그람 
C ： 

oldval = pvm _ setopt ( PvmRoute , PvmRouteDirect ); 
포트란: 

CALL PVMFSETOPT ( PVMAUTOERR , 1, OLD VAL ) 
오유: 

이름 가능한 경우 

PvmBadParam 무효한 변수 

pvmfsetrbuf 0 pvm_setrbuf 0 

능동수신완충기를 절환하고 그것을 이전의 완충기에 보관한다. 

문법 

C ： 

int oldbuf = pvm_setrbuf ( int bufid ) 

포트란: 

call pvmfsetrbuf ( bufid , oldbuf ) 

변수 

bufid — 새 로운 능동수신완중기 에 대 한 통보완중기 식 별 자를 지 적 하는 
옹근수 

oldbuf - 이 전의 능동수신완충기 에 대 한 통보완충기식 별 자를 
돌려주는 옹근수 
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설명 

pvm _ setrbuf 는 능동수신완충기를 bufid 로 절환하고 그것을 이전의 
완충기 oldbuf 에 보관한다. bufid = 0으로 설정하면 현재 의 능동수신 
완중기 가 보관되 며 능동인 수신완중기 는 존재 하지 않는다. 수신 이 성 파 
적으로 진행되면 새로운 능동수신완중기가 창조된다. 

만일 이전에 수신한 통보를 풀지 않고 보관할것을 요구한다면 이전의 
bufid 를 보관하고 후에 풀기 위해 능동수신완충기 를 재 설정할수 있다. 
이 함수는 다중통보완충기 들을 관리할 때 필요하다. 


실례프로그람 
C ： 

rbufl = pvm_setrbuf ( rbuf 2 ); 

포트란: 

CALL PVMFSETRBUF ( NEWBUF，OLDBUF ) 

오유: 


이름 

PvmBadParam 

PvmNoSuchBuf 


가능한 경우 
무효한 bufid 

존재하지 않는 통보완충기 로 절 환하였 다. 


pvmfsetsbuf 0 


pvm_setsbuf 0 


능동송신 완충기 에 로 절 환한다. 

문법 

C ： 

int oldbuf = pvm_setsbuf ( int bufid ) 

포트란: 

call pvmfsetsbuf ( bufid , oldbuf ) 

변수 

bufid - 새 로운 능동송신완충기 를 위한 통보완충기 식 별 자， 
기 정 값은 0으로 설 정한다. 
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oldbuf - 이 전의 능동송신완충기를 위한 통보완충기식 별자 
설명 

pvm _ setsbuf 는 능동송신완충기를 bufid 로 절환하고 그것을 이전의 
완충기 oldbuf 에 보관한다. 

bufid = 0으로 설정하면 현재 의 능동송신완충기 가 보관되 며 능동인 
송신완충기 는 존재하지 않는다. 

실례프로그람 
C ： 

sbufl = pvm_setsbuf ( sbuf 2 ); 

포트란: 

CALL PVMFSETSBUF ( NEWBUF，OLDBUF ) 

오유: 


이름 

PvmBadParam 

PvmNoSuchBuf 


가능한 경우 
무효한 bufid 
존재하지 않는 통보완충기 


pvmfspawnO 


pvm _ spawn () 


새 로운 병 렬 가상기계 과제 를 시 동한다. 


문법 


C ： 

int numt = pvm _ spawn ( char * task , char ** argv , 

int flag , char * where , int ntask , int *tids ) 


포트란: 


call pvmfspawn ( task , flag , where , ntask , tids , numt ) 


변수 
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task 


- 실행가능한 이름을 가지고있는 문자렬， 실행프로그람은 
이 미 전에 실 행 하는 처 리 기 에 있 어 야 한다. 기 정 의 위 치 는 
$ HOME / pvm 3/ bin /$ PVM _ ARCH/filename 이 다 
argv - 배 렬의 끝이 null 문자로 끝나는 실행프로그람의 
변수배렬에로의 지적자，만일 프로그람이 변수를 가지지 
않으면 이 명령의 두번째 변수는 null 로 된다. 
flag - 실 행 추가선택 을 지 적하는 옹근수， C 에 서 flag 는 다음 
추가선택들의 합으로 된다. 


추가선택 

PvmTaskDefault 0 

PvmTaskHost 1 
PvmTaskArch 2 
PvmTaskDebug 4 
PvmTaskTrace 8 
PvmMppFront 16 

PvmHostCompl 32 


값 의 미 

PVM 은 과제를 실행할 임의의 호 
스트를 선택할수 있 다. 

구체 적 인 처 리 기를 지 적 한다. 

구성 방식 을 지 정한다. 

오유수정 도구우에 서 프로쎄 스를 실 행한다. 
프로쎄 스는 PVM 추적자료를 생 성한다. 
MPP 의 front-end 마디에서 프로쎄스를 
실 행 한다. 

처 리기의 보모임(지적된 처리기가 속하지 
않은 남은 처리기들)을 리용한다. 


where - 프로쎄스를 어 디서 실행 시 키는가를 지 적하는 문자렬 

flag 의 값에 따라 처리기의 이름은 
“ ibml . epm . oml . gov ” 혹은 “ SUN 4” 와 같은 PVM 
의 구성 방식일수 있다. flag = 0이 면 where 는 무시 되 며 
병 렬가상기 계는 가장 적 절한 처 리 기를 선택한다. 
ntask - 실행 할 프로그람개수를 지 적 하는 옹근수 
tids - 적어도 ntask 길이를 가진 배렬， 귀환하면 배렬은 
pvm_spawn 호출에 의해 시 동된 병 렬 가상기계프로쎄 스들의 
tid 들을 가지 고있다. 만일 어떤 과제를 실행할 때 오유가 
생기면 배렬에서 그 과제에 해당한 위치에는 오유코드가 
설정된다. 
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numt - 실행되 는 과제 들의 실제개수가 설정된다. 오유가 생 기면 
0보다 작은 값이 설정된다. 부분적인 오유가 생기면 
ntask 보다 작은 값이 설정된다. 


설명 

pvm_spawn 은 task 라는 이름을 가진 ntask 개의 프로그람들을 
실행한다. 환경변수를 제 공하는 체 계 에서 는 이 미 환경 에 설정된 
환경변수가 아들과제 들에 넘어 간다. 즉 환경변수 PVM _ EXPORT 가 
넘 어 간다. 

PVM _ EXPORT 가 “:” 으로 다른 변수를 구분하면 그것들도 
넘어 간다. 이 것은 실례 로 다음과 같은 경우 쓸모있다. 

setenv DISPLAY myworksta 吐 on :0. 0 

setenv MYSTERYVAR 13 

setenv PVM_EXPORT DISPLAY : MYSTERYVAR 

병 렬가상기계프로쎄스들을 실행하는 처 리기들은 flag 와 where 변수 
로 지 적한다. 귀 환하면 tids 배 렬은 실행된 매 개 과제 들의 식 별자들을 
가지고있 다. 

pvm _ spawn 는 한개 이 상의 과제 들을 실 행 할수 있는데 numt 는 
실행할 과제 들의 실지개수를 가지 고있다. 

체 계 오유가 발생 하면 numt < 0으로 된 다. 만일 numt =< 

ntask 이 면 일부 프로그람들이 실행시 오유가 발생 하였 다는것 을 보여주며 
이때 리용자는 관련한 오유코드들을 가지 고있는 tids 배 렬 에서 
오유원인들을 조사할수 있다. 배렬에서 첫 numt 개의 tids 들은 정상이며 
따라서 이 과제 들과는 정 상적 인 통신을 실 행할수 있 다. 

flag 가 0으로 설정되고 where 가 NULL (혹은 포트란에서는 로 
설정되 면 계 발식방법 을 적 용하여 ntask 개의 프로쎄스들을 가상기 계 에 
분배한다. 현재 계 발식방법은 표에 등록된 처 리기들에 차례로 과제들을 
분배하는 균등분배이 다. 

만일 PvmHostCompl 기 발이 설 정 되 면 결 과의 처 리 기 모임 은 지 적 된 
처 리기 가 포함되지 않은 보조모임 으로 된다. 또한 TaskHost 로 지적한 
처 리 기 이 름은 국부처 리 기 로서 주어 진 다. 
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where 에 다중처 리 기 가 설 정 되 면 pvm_spawn 은 제 작자전용의 
기 능을 리 용하여 ntask 개 의 과제 들을 이 단일 처 리 기 우에 서 실 행한다. 

PvmTaskDebug 가 설 정 되 면 pvmd 는 오유수정 도구우에 서 과제 들을 
실 행 한다. 

이 경 우 pvm3 八 Din/ARCH/ 등록부에 있는 과제 들을 실 행하는것 이 
아니 라 pvm3/lib/debugger# 실행한다. 

오유제거기는 리용자들이 개별적인 과제들을 수정할수 있는 쉘각본 
프로그람이 다. 

실례프로그람 
C ： 

numt = pvm_spawn( "host", 0, PvmTaskHost, 

"sparky", 1, &tid[0] ); 

numt = pvm_spawn( "host", 0, (PvmTaskHost+ 
PvmTaskDebug), "sparky", 1, &tid[0] ); 
numt = pvm_spawn( "node", 0, PvmTaskArch, 

"RIOS", 1, &tid[i] )； 

numt = pvm_spawn( "FEM1", args, 0, 0, 16, 

tids ); 

numt = pvm_spawn( "pde", 0, PvmTaskHost, 

"paragon.ornl", 512, tids ); 

포트란 : 

FLAG = PVMARCH + PVMDEBUG 

CALL PVMFSPAWN( ’node’ ， FLAG, ’SUN4’ ， 1 ， 

TID(3), NUMT ) 

CALL PVMFSPAWN( ’FEM1’ ， PVMDEFAULT, ’*，， 

16 ， TIDS, NUMT ) 

CALL PVMFSPAWN( ’TBMD’ ， PVMHOST, 

’cm5.utk.edu’ ， 32 ， TIDS, NUMT ) 

오유: 


이름 


값 
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가능한 경우 



PvmBadParam 

-2 

무효한 변수가 지정 

PvmNoHost 

-6 

지적한 처리기가 가상기계에 없다. 

PvmNoFile 

-7 

지적한 프로그람을 찾을수 없다. 

기 정 위 치 는 ~/ pvm 3/ bin /$ ARCH 이 다. 
여기서 ARCH 는 PVM 의 구성 방식이름 
이 다. 

PvmNoMem 

-10 

malloc 가 실 패 하였 다. 기 억 기 부족 

PvmSysErr 

- 14 

pvmd 가 웅답하지 않는다. 

PvmOutOfRes 

-27 

자원이 부족 


pvmftasksO 


pvm_tasks 0 


가상기 계 에서 실행하는 과제 들에 대 한 정 보를 준다. 


문법 


C ： 


int info = pvm_tasks ( int where , int * ntask , 

struct pvmtaskinfo **taskp ) 


struct pvmtaskinfo 


int ti _ tid ; 
int ti _ ptid ; 
int ti _ host : 
int ti _ flag ； 
char * ti _ a _ out : 
int ti _ pid : 

} taskp ； 

포트란: 


call pvmftasks ( where , ntask , tid , ptid , 
dtid , flag , aout , info ) 

변수 

where — 정보를 요구하는 파제를 지적한다, 주가선택들은 다음파 
같다. 
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0 가상기계에 있는 모든 과제들 
pvmd tid 주어진 처리기의 모든 과제들 
tid 지적한 과제 

ntask - 실 행 하는 과제 들의 개 수를 지 적 

taskp - 그의 과제 id, 어 미 과제 의 tid, pvmd 의 과제 id, 상태 기발， 
이 과제의 프로그람이름，과제의 프로쎄스 id (OS 에 
의존)와 같은 정보들을 가지고있는 구조체배렬에로의 
지적자 

tid - 어떤 과제의 과제 ID 를 지적 

ptid - 어미과제의 과제 id 를 지적 

dtid - 과제가 있는 처리기의 pvmd 과제의 과제 id 

flag - 과제의 상태 

aout - 시 동한 과제 의 과제이 름，수동적 으로 시 동한 과제 는 공백 을 
돌려 준다. 

info - 이 함수가 돌리는 상태 코드， 오유가 생기면 0 보다 작은 값이 
설정 

설명 

pvm_tasks 는 가상기 계 에 서 실 행 하는 과제 들에 대 한 정 보를 준다. 이 
정 보는 조작탁지 령 ps 로 얻는 정 보와 같다. 

C 함수는 한번의 호줄로 가상기 계 전체 에 대 한 정 보를 얻 는다. 

포트란함수는 한번의 호출로 하나의 과제에 대한 정보를 엄으므로 
가상기계 전체에 대한 과제정보를 엄으려면 파제개수만큼 호줄을 
반복하여 야 한다. 

pvm_tasks 는 성공하면 info = 0 으로 되며 오유가 생기면 info < 
0으로 된다. 

실례프로그람 
C ： 

info = pvm_tasks ( 0 ， Sntask, & taskp ) : 

포트란 : 

CALL PVMFTASKS ( DTID , NTASK , INFO ) 
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오유: 


이름 

PvmBadParam 

PvmSysErr 

PvmNoHost 


가능한 경우 
where 변수가 틀렸다. 
pvmd 가 웅답하지 않는다. 

가상기계에는 그런 처리기가 없다. 


pvmftidtohostO 


pvm _ tidtohost () 


지적된 과제가 실행되는 마디점콤퓨터의 처리기번호를 되돌린다. 


문법 

C ： 

int d 社 d = pvm _ tidtohost ( int tid ) 

포트란 : 

call pvmftidtohost ( tid , dtid ) 

변수 

tid 一 문의하는 PVM 프로쎄스의 옹근수과제 식별자 
dtid 一 마디점 콤퓨터 에 서 실 행하는 데 몬의 과제식 별 자를 

되돌리는 옹근수，혹은 오유가 있으면 부의 옹근수 

설명 

이 함수는 tid 로 식 별되 는 프로쎄 스가 있는 마디점 콤퓨터 
식별 자를 돌려 준다. 

실례프로그람 
C ： 

host = pvm_tidtohost ( tid [0] ) ； 

포트란 : 

CALL PVMFTIDTOHOST ( TID , HOSTID ) 

오유: 

이름 가능한 경우 

PvmBadParam — 무효인 tid 값이 지적되 였다. 
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PvmSysErr 


pvmd 가 응답없 다. 


pvmftrecvO pvm 一 trecvO 

기 다림한계 시 간을 가지 고 수신한다. 

문법 

C ： 

int bufid = pvm_trecv ( int tid , int msgtag , 

struct timeval *tmout ) 

포트란: 

call pvmftrecv ( tid , msgtag , sec , usee , bufid ) 

변수 

tid - 송신프로쎄 스의 과제 식 별 자 

msgtag - 통보표적，이것은 0보다 작지 말아야 한다. 

tmout - 통보를 받지 못하였 을 때 귀 환하기전 에 기 다리 는 시 간 

sec , usee - 기 1 4리 는 시 간지 정 ?々 

bufid - 새로운 능동수신완충기의 값，오유가 생기면 0보다 작은 
값이 설정된다. 

설명 

pvm_trecv 는 msgtag 라는 표식을 단 통보가 tid 로부터 도착할 
때 까지 프로쎄 스를 봉쇄 한다. pvm_trecv 는 다음 통보를 새 로운 
능동수신완중기 에 배 치 하며 현재 수신완중기 를 지 운다. 

지적한 기 다림 시 간내 에 일치하는 통보가 도착하지 않으면 
pvm_trecv 는 통보가 없이 귀환한다. msgtag = -1 이든가 tid = -1 이면 
임의의 통보를 접수한다. 이때 리용자는 아래의 추가선택 들중 임의의 
추가선택 을 리용할수 있 다. 

tid = ᅳ1 이 고 msgtag 를 리용자가 정 의하였 다면 pvm_trecv 는 
임의의 프로쎄스로부터 msgtag 를 가진 통보를 접수할수 있다. 

msgtag = -1이 고 吐 d 를 리 용자가 정 의하였 다면 pvm_trecv 는 
프로쎄스 tid 가 보내는 임의의 통보를 접수한다. 
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tid = -1 이고 msgtag = 一 1 이면 pvm 一 trecv 는 임의의 프로쎄스 
로부터 임의의 통보를 접수한다. 

C 에서 시간마당 tv_sec 와 tv_usec 는 pvm_trecv 가 얼마나 오래동안 
통보를 기 다려 야 하는가를 지 적 한다. 

두 값을 다 0 으로 설 정 하면 pvm_trecv 는 pvm_nrecv() 처 럼 
동작하는데 이 것은 통보를 조사하고 일 치하는것 이 없으면 즉시 돌아온다. 

C 에서 이 마당에 null 지 적자를 넘 기면 pvm_trecv 는 pvm_recv() 
처 럼 동작한다. 즉 무한대기 한다. 

포트란에 서 는 sec 를 0 으로 설정하면 같은 효과를 가전다. 

병 렬가상기계모델은 통보의 순서를 보존한다. 

만일 과제 1이 통보 A 를 과제 2에 보내고 그 다음 과제 1이 통보 
B 를 과제 2 에 보내면 통보 A 는 통보 묘보다 과제 2에 먼저 도착한다. 
더 우기 두 통보들이 과제 2가 접 수하기전에 도착해 도 항상 통보 A 를 
먼저 접수한다. 

pvm_trecv 는 성공하면 능동수신완충기의 식별자가 bufid 에 설정 
된다. 오유가 생기면 bufid < 0 으로 된다. 

일 단 pvm_trecv 가 귀 환하면 통보에 있는 자료는 풀기 함수를 
리용하여 리용자의 기억기에 풀린다. 

실례프로그람 

C ： 

struct 吐 meval tmout ； 

tid = pvm_parent() : 

msgtag = 4 ; 

if ((bufid = pvm_trecv( tid, msgtag, Stmout )) >0) { 
pvm_upkint( tid_array, 10, 1 ); 
pvm_upkint( problem_size, 1, 1 ); 
pvm_upkfloat( input_array, 100, 1 ); 

} 

포트란 : 

CALL PVMFRECV( -1, 4, 60 ， 0， BUFID ) 

IF (BUFID .GT. 0) THEN 

CALL PVMFUNPACK( INTEGER4, TIDS ， 25 ， 1, INFO ) 
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CALL PVMFUNPACK( REAL8, MATRIX, 100 ， 100， INFO ) 
ENDIF 


오유 : 

가능한 경우 

무효 tid 값 혹은 msgtag <-1 
pvmd 가 응답하지 않는다 . 

pvm_upk*() 


PvmBadParam 

PvmSysErr 

p vmf unpack () 


능동통보완충기를 기입된 자료형을 가진 배렬로 푼다 . 

문법 

C ： 

int info = pvm_unpackf( const char *fmt，... ) 
int info = pvm_upkbyte( char *xp，int nitem, int stride ) 
int info = pvm_upkcplx( float *cp, int nitem, int stride ) 
int info = pvm_upkdcplx( double *zp, int nitem, int stride ) 
int info = pvm_upkdouble(double *dp, int nitem, int stride ) 
int info = pvm_upkfloat( float *fp, int nitem, int stride ) 
int info = pvm_upkint( int *ip, int nitem, int stride ) 
int info = pvm_upklong( long *ip, int nitem, int stride ) 
int info = pvm_upkshort( short *jp, int nitem, int stride ) 
int info = pvm_upkstr( char *sp ) 


포트란 : 

call p vmf unpack ( what, xp, nitem, stride, info ) 


변수 

fmt - 무엇을 압축하는가를 지정하는 인쇄 가능한 형 식의 표기 
nitem - 풀어야 할 항목들의 총 개수 
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stride 


- 항목들을 압축할 때 리용한 걸음， 실례 로 
pvm_upkcplx 에서 stride = 2이면 다른 복소수를 푼다. 
xp - 바이 트블로크의 시 작점에 로의 지 적 자，임의의 자료형 이 
될수 있지만 대응하는 압죽자료형과 일치해야 한다. 
cp - 적어도 nitem*stride 개의 항목들을 가지고있는 복소수배렬 
zp - 적 어도 nitem*stride 개의 항목들을 가지 고있는 배정 확도 
복소수배 렬 

dp - 적 어도 nitem*stride 개의 항목들을 가지 고있는 배정 확도 
실 수배 렬 

fp - 적어도 nitem*stride 개의 항목들을 가지고있는 실수배렬 
ip - 적 어도 nitem*stride 개의 항목들을 가지 고있는 옹근수배 렬 
jp - 적어도 nitem*stride 개의 항목들을 가지고있는 옹근수*2배렬 
sp - null 로 끝나는 문자렬 
what - 풀기 할 자료의 형 을 지 적 하는 옹근수 


what 

STRING 0 
BYTE 1 1 

INTEGER 2 2 
INTEGER 4 3 


추가선택 

REAL 4 4 

COMPLEX 8 5 

REAL 8 6 

COMPLEX 16 7 


info - 상태코드，오유가 생기면 0보다 작은 값이 설정한다. 

설명 

매 pvm _ upk * 함수들은 능동수신완충기로부터 주어 진 자료형의 배 렬 
들을 푼다. 매 함수에 서 변수는 풀기할 배 렬 에 로의 지 적 자이 며 nitem 은 
줄 항목들의 전체 개 수， stride 는 줄기 시 에 리 용하는 걸 음을 지 적 한다. 

여기서 례외는 pvm _ upkstr () 인데 이것은 정의에 따라 null 로 
끝나는 문자렬을 풀며 따라서 nitem , stride 와 같은 변수를 요구하지 
않는다. 

포트란함수 pvmfunpack ( STRING , ...) 에서는 문자렬에 있는 
문자들의 개수로 nitem 을 취급하며 stride =1로 한다. 

이 함수는 성공하면 info = 0이며 오유가 생기면 info < 0으로 된다. 
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단일 변수는 nitem = l ， stride=l 로 하여 풀수 있다. 
pvm_unpackf () 는 인쇄가능한 형식의 표기를 리 용하여 자료를 
무엇으로 또 어떻게 압축하여 송신완충기에 보관하는가를 지적한다. 
모든 변수는 주소로서 넘어 간다. BNF 와 류사한 형 식 적서 술법 이 
리용된 다. 


format : null | init I format fmt 

init : null | ’%’ ’ + ’ 

fmt :，%’ count stride modifiers fchar 

fchar : ’ c ’ | ’ d ’ | T | ’ x ’ | ’ s ’ 

count : null | [0-9] + | 

stride : null I ( [0-9]+ | ) 

modifiers : null | modifiers mchar 

mchar : ’ h ’ | T [ ’ u ’ 

형식: 

+ 는 initsend 를 의미 하며 param 목록에 있는 int 와 일치해 야 한다. 
c 압축/풀기할 바이 트를 지 적한다. 
d 옹근수 
f 류점수 
x 배정도 류점수 
S 문자렬 

략자: 

h short ( int ) 

1 long ( int , float , complex float ) 
u unsigned ( int ) 

count 나 stride 는 param 목록에 있는 int 와 일치해야 한다. 

실례 

C ： 

info = pvm _ recv ( tid , msgtag ) ； 
info = pvm _ upkstr ( string ); 
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info = pvm_upkint( 技 size ， 1， 1 ); 

info = pvm_upkint( array, size, 1 ); 

info = pvm_upkdouble ( matrix, size*size, 1 ); 

포트란 : 

CALL PVMFRECV( TID, MSGTAG ); 

CALL PVMFUNPACK( INTEGERS NSIZE, 1, 1, INFO ) 
CALL PVMFUNPACK( STRING, STEPNAME, 8, 1, 

INFO ) 

CALL PVMFUNPACK( REAL4, A(5,l), NSIZE, 

NSIZE ,INFO ) 


오유 : 


이름 

PvmNoData 


PvmBadMsg 


PvmNoBuf 


가능한 경우 

수신완충기의 끝을 초과하여 읽 었다 . 

이 오유는 대체로 완충기에 본래 압축한 
개수보다 더 많은 항목들을 풀려고 할 때 
나타난다 . 

수신한 통보를 해 신할수 없다 . 이 오유는 
대체로 처리기들이 서로 다른 기종일 때 
나타난다 . 

이때는 PvmDataDefault 로 해신해보시오 . 
풀기 할 능동인 수신완충기 가 없 다 . 
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